Hyrax: BES Administrative Commands: Difference between revisions
(13 intermediate revisions by the same user not shown) | |||
Line 23: | Line 23: | ||
</hai:BesAdminCmd> | </hai:BesAdminCmd> | ||
===== Response | ===== Response Examples ===== | ||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
Line 29: | Line 29: | ||
<hai:OK/> | <hai:OK/> | ||
</hai:BesAdminCmd> | </hai:BesAdminCmd> | ||
Here are the two kinds of errors possible: | |||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
Line 39: | Line 41: | ||
''message text'' | ''message text'' | ||
</hai:BESError> | </hai:BESError> | ||
=== StopNow === | === StopNow === | ||
Line 46: | Line 47: | ||
<hai:StopNow/> | <hai:StopNow/> | ||
Stops all beslistener processes; does not wait for current transmissions to complete | Stops all beslistener processes; does not wait for the current transmissions to complete | ||
Line 55: | Line 56: | ||
</hai:BesAdminCmd> | </hai:BesAdminCmd> | ||
===== Response | ===== Response Examples ===== | ||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
Line 61: | Line 62: | ||
<hai:OK/> | <hai:OK/> | ||
</hai:BesAdminCmd> | </hai:BesAdminCmd> | ||
Here are the two kinds of errors possible: | |||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
Line 72: | Line 75: | ||
</hai:BESError> | </hai:BESError> | ||
=== Exit === | |||
- | Element form: | ||
<hai:Exit /> | |||
Shutdown the BES. This forces the daemon to exit, so the command interface the HAI uses to start and stop listeners is ''gone''. A user will have to restart the daemon manually. | |||
===== Request Example ===== | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | |||
<hai:Exit /> | |||
</hai:BesAdminCmd> | |||
===== Response Example ===== | |||
There's no response. | |||
=== GetConfig === | === GetConfig === | ||
Line 87: | Line 104: | ||
<hai:GetConfig /> | <hai:GetConfig /> | ||
</hai:BesAdminCmd> | </hai:BesAdminCmd> | ||
===== Response Example ===== | ===== Response Example ===== | ||
<pre> | <pre> | ||
<?xml version="1.0" encoding="ISO-8859-1"?> | <?xml version="1.0" encoding="ISO-8859-1"?> | ||
<hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | ||
<hai: | <hai:GetConfig module="bes.conf"> | ||
... | ... | ||
</hai: | </hai:GetConfig> | ||
<hai: | <hai:GetConfig module="h4.conf"> | ||
... | ... | ||
</hai: | </hai:GetConfig> | ||
... | ... | ||
</hai:BesAdminCmd> | </hai:BesAdminCmd> | ||
</pre> | </pre> | ||
=== SetConfig === | === SetConfig === | ||
Line 166: | Line 163: | ||
Returns a status indicating what happened (Was the configuration accepted, was it valid, did the bes restart, etc) | Returns a status indicating what happened (Was the configuration accepted, was it valid, did the bes restart, etc) | ||
<pre> | |||
<?xml version="1.0" encoding="ISO-8859-1"?> | |||
<hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | |||
<hai:OK>Please restart the server for these changes to take affect.</hai:OK> | |||
</hai:BesAdminCmd> | |||
</pre> | |||
Here are the two kinds of errors possible: | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<hai:ParseError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | |||
''message text'' | |||
</hai:ParseError> | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<hai:BESError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | |||
''message text'' | |||
</hai:BESError> | |||
=== TailLog === | === TailLog === | ||
Line 202: | Line 218: | ||
</hai:BesAdminCmd> | </hai:BesAdminCmd> | ||
</pre> | </pre> | ||
=== GetLogContents === | |||
Element form: | |||
<hai:GetLogContents /> | |||
Retrieves information about all of the existing (available) log contexts for the BES. | |||
===== Request Example ===== | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | |||
<hai:GetLogContents /> | |||
</hai:BesAdminCmd> | |||
===== Response Examples ===== | |||
<pre> | |||
<?xml version="1.0" encoding="ISO-8859-1"?> | |||
<hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | |||
<hai:LogContext name="ascii" state="on"/> | |||
<hai:LogContext name="besdamone" state="on"/> | |||
<hai:LogContext name="nc" state="off"/> | |||
... | |||
</hai:BesAdminCmd> | |||
</pre> | |||
If there are no contexts, the response will be empty: | |||
<pre> | |||
<?xml version="1.0" encoding="ISO-8859-1"?> | |||
<hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | |||
</hai:BesAdminCmd> | |||
</pre> | |||
=== SetLogContents === | |||
Element form: | |||
<hai:SetLogContents name="..." state="..." /> | |||
Set the loggin context for ''name'' to ''state''. | |||
===== Request Example ===== | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | |||
<hai:SetLogContents name="ascii" state="on" /> | |||
<hai:SetLogContents name="besdaemon" state="off" /> | |||
</hai:BesAdminCmd> | |||
===== Response Examples ===== | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | |||
<hai:OK/> | |||
</hai:BesAdminCmd> | |||
Here are the two kinds of errors possible: | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<hai:ParseError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | |||
''message text'' | |||
</hai:ParseError> | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<hai:BESError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> | |||
''message text'' | |||
</hai:BESError> |
Latest revision as of 22:53, 6 October 2011
BES Administration Commands
The general form for all of the HAI commands is as follows: Namespace: http://xml.opendap.org/ns/bes/admin/1.0#
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> ... </hai:BesAdminCmd>
Start
Example:
<hai:Start />
Starts the master beslistener process. If a beslistner is already running nothing will be done.
Request Example
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:Start /> </hai:BesAdminCmd>
Response Examples
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:OK/> </hai:BesAdminCmd>
Here are the two kinds of errors possible:
<?xml version="1.0" encoding="UTF-8"?> <hai:ParseError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> message text </hai:ParseError>
<?xml version="1.0" encoding="UTF-8"?> <hai:BESError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> message text </hai:BESError>
StopNow
Example:
<hai:StopNow/>
Stops all beslistener processes; does not wait for the current transmissions to complete
Request Example
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:StopNow/> </hai:BesAdminCmd>
Response Examples
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:OK/> </hai:BesAdminCmd>
Here are the two kinds of errors possible:
<?xml version="1.0" encoding="UTF-8"?> <hai:ParseError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> message text </hai:ParseError>
<?xml version="1.0" encoding="UTF-8"?> <hai:BESError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> message text </hai:BESError>
Exit
Element form:
<hai:Exit />
Shutdown the BES. This forces the daemon to exit, so the command interface the HAI uses to start and stop listeners is gone. A user will have to restart the daemon manually.
Request Example
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:Exit /> </hai:BesAdminCmd>
Response Example
There's no response.
GetConfig
Element form:
<hai:GetConfig />
Retrieves the BES configuration file.
Request Example
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:GetConfig /> </hai:BesAdminCmd>
Response Example
<?xml version="1.0" encoding="ISO-8859-1"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:GetConfig module="bes.conf"> ... </hai:GetConfig> <hai:GetConfig module="h4.conf"> ... </hai:GetConfig> ... </hai:BesAdminCmd>
SetConfig
Element form:
<hai:SetConfig module="module-name"> ...Module Name Configuration Content... </hai:SetConfig>
Note that module-name is actually any of the configuration files (bes.conf, h4.conf) and that while we use some conventions, a bes really has a collection of files that are all sourced to form the current configuration. So we're showing files and it's assumed that in most cases those roughly correspond to the main configuration file for the bes and smaller files specific to individual modules.
Request Example
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:SetConfig module="ncml_module"> ...NcML Module Configuration Content... </hai:SetConfig> </hai:BesAdminCmd>
Response Example
Returns a status indicating what happened (Was the configuration accepted, was it valid, did the bes restart, etc)
<?xml version="1.0" encoding="ISO-8859-1"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:OK>Please restart the server for these changes to take affect.</hai:OK> </hai:BesAdminCmd>
Here are the two kinds of errors possible:
<?xml version="1.0" encoding="UTF-8"?> <hai:ParseError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> message text </hai:ParseError>
<?xml version="1.0" encoding="UTF-8"?> <hai:BESError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> message text </hai:BESError>
TailLog
Use this to get a 'tail' of the BES log.
Element form:
<hai:TailLog lines="integer"/>
Note that the value zero (0) has the special meaning to get all of the lines in the log.
Request Example
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:TailLog lines="200"/> </hai:BesAdminCmd>
Response Example
Element form:
<hai:BesLog/>
<?xml version="1.0" encoding="ISO-8859-1"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:BesLog> [MDT Thu May 26 15:10:49 2011 id: 58293] 58293 from ip 127.0.0.1, port 62858 [set context dap_explicit_containers to no;] received [MDT Thu May 26 15:10:49 2011 id: 58293] 58293 from ip 127.0.0.1, port 62858 [set context errors to dap2;] received [MDT Thu May 26 15:10:49 2011 id: 58293] 58293 from ip 127.0.0.1, port 62858 [set container in catalog values catalogContainer,/data/nc/dapbench_test.nc;] received ... [MDT Fri May 27 12:10:00 2011 id: 86266] 86266 from ip 127.0.0.1, port 65245 [get html_form for d1 return as dap2 using http://localhost:8080/opendap/hyrax/data/nc/bears.nc] received </hai:BesLog> </hai:BesAdminCmd>
GetLogContents
Element form:
<hai:GetLogContents />
Retrieves information about all of the existing (available) log contexts for the BES.
Request Example
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:GetLogContents /> </hai:BesAdminCmd>
Response Examples
<?xml version="1.0" encoding="ISO-8859-1"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:LogContext name="ascii" state="on"/> <hai:LogContext name="besdamone" state="on"/> <hai:LogContext name="nc" state="off"/> ... </hai:BesAdminCmd>
If there are no contexts, the response will be empty:
<?xml version="1.0" encoding="ISO-8859-1"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> </hai:BesAdminCmd>
SetLogContents
Element form:
<hai:SetLogContents name="..." state="..." />
Set the loggin context for name to state.
Request Example
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:SetLogContents name="ascii" state="on" /> <hai:SetLogContents name="besdaemon" state="off" /> </hai:BesAdminCmd>
Response Examples
<?xml version="1.0" encoding="UTF-8"?> <hai:BesAdminCmd xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> <hai:OK/> </hai:BesAdminCmd>
Here are the two kinds of errors possible:
<?xml version="1.0" encoding="UTF-8"?> <hai:ParseError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> message text </hai:ParseError>
<?xml version="1.0" encoding="UTF-8"?> <hai:BESError xmlns:hai="http://xml.opendap.org/ns/bes/admin/1.0#"> message text </hai:BESError>