| 1 |
<?xml version="1.0" encoding="iso-8859-1"?> |
| 2 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| 3 |
<html xmlns="http://www.w3.org/1999/xhtml"> |
| 4 |
<head><title>CEA Implementation (Working Draft)</title> |
| 5 |
|
| 6 |
<script src="style/toc.js" language="JavaScript" type="text/javascript" ></script> |
| 7 |
|
| 8 |
<link href="style/ivoa_document.css" rel="stylesheet" type="text/css" /> |
| 9 |
<!-- set the class of the body appropriately to change the status of the document --> |
| 10 |
<link href="style/toc.css" rel="stylesheet" type="text/css" /> |
| 11 |
<link href="style/extra.css" rel="stylesheet" type="text/css" /> |
| 12 |
</head><body bgcolor="white" onload="toc()"> |
| 13 |
|
| 14 |
<div class="head"> |
| 15 |
<a href="http://www.ivoa.net/"><img alt="IVOA" src="http://www.ivoa.net/pub/images/IVOA_wb_300.jpg" height="169" width="300" /></a> |
| 16 |
|
| 17 |
<h1>CEA Implementation: The Astrogrid Implentation of the Common Execution Architecture<br /> |
| 18 |
Version 1.0 </h1> |
| 19 |
|
| 20 |
<h2>IVOA Working Draft <!-- #BeginDate format:Sw1 -->11 December, 2006<!-- #EndDate --> |
| 21 |
</h2> |
| 22 |
|
| 23 |
|
| 24 |
<dl> |
| 25 |
<dt>This version:</dt> |
| 26 |
<dd><a href="http://www.ivoa.net/Documents/WD/GWS/CEAInterface-XXXX.html"> |
| 27 |
http://www.ivoa.net/Documents/WD/GWS/CEAInterface-XXXX.html</a></dd> |
| 28 |
|
| 29 |
<dt>Latest version:</dt> |
| 30 |
<dd><a href="http://www.ivoa.net/Documents/latest/CEAInterface.html"> |
| 31 |
http://www.ivoa.net/Documents/latest/CEAInterface.html</a></dd> |
| 32 |
|
| 33 |
<dt>Previous versions</dt> |
| 34 |
</dl> |
| 35 |
|
| 36 |
<dl> |
| 37 |
<dd><a href="http://www.ivoa.net/Documents/WD/ReR/VOResource-20060620.html"> |
| 38 |
</a></dd> |
| 39 |
<dt>Authors:</dt> |
| 40 |
<dd> |
| 41 |
<a href="http://www.ivoa.net/twiki/bin/view/IVOA/PaulHarrison"> |
| 42 |
Paul Harrison</a>, Editor<br /> |
| 43 |
and the IVOA Grid and Web Services Working Group. |
| 44 |
</dd> |
| 45 |
</dl> |
| 46 |
<hr /> |
| 47 |
</div> |
| 48 |
|
| 49 |
<h2><a name="abstract" id="abstract">Abstract</a></h2> |
| 50 |
|
| 51 |
This document describes the astrogrid implemenation of the Common Execution Architecture (CEA). In particular a implementation of a Commandline Common Execution Controller is described which allows legacy commandline applications to be presented as IVOA Standard web services with a minimum of effort. |
| 52 |
<div class="status"> |
| 53 |
<h2><a name="status" id="status">Status of this document</a></h2> |
| 54 |
|
| 55 |
<p>This is an IVOA Working Draft for review by IVOA members and other |
| 56 |
interested parties. It is a draft document and may be updated, |
| 57 |
replaced, or obsoleted by other documents at any time. It is |
| 58 |
inappropriate to use IVOA Working Drafts as reference materials or to |
| 59 |
cite them as other than "work in progress."</p> |
| 60 |
<p>Parts that the editor considers should be removed from the document are marked in <span class="draftdelete">red with a strike through line</span>, and parts to be expanded are <span class="draftedit">in green</span></p> |
| 61 |
<p> |
| 62 |
A list of <a href="http://www.ivoa.net/Documents/">current IVOA |
| 63 |
Recommendations and other technical documents</a> can be found at |
| 64 |
http://www.ivoa.net/Documents/. </p> |
| 65 |
|
| 66 |
</div> |
| 67 |
<h2><a id="acknowledge" name="acknowledge">Acknowledgements</a></h2> |
| 68 |
|
| 69 |
<p>This document has been developed with support from the <a href="http://www.pparc.ac.uk/">UK Particle Physics and Astronomy |
| 70 |
Research Council (PPARC)</a>, and from the |
| 71 |
<a href="http://fp6.cordis.lu/fp6/home.cfm">Eurpean Commission's Sixth |
| 72 |
Framework Program</a> via the <a href="http://www.astro-opticon.org/"> |
| 73 |
Optical Infrared Coordination Network (OPTICON)</a>. </p> |
| 74 |
|
| 75 |
<a name="conf" id="conf"> |
| 76 |
<h3>Conformance-related definitions</h3></a> |
| 77 |
|
| 78 |
The words "MUST", "SHALL", "SHOULD", "MAY", "RECOMMENDED", and |
| 79 |
"OPTIONAL" (in upper or lower case) used in this document are to be |
| 80 |
interpreted as described in IETF standard, RFC 2119 |
| 81 |
<a href="#should">[RFC 2119]</a>. <p> |
| 82 |
|
| 83 |
The <a name="d:vo" id="d:vo"><strong>Virtual Observatory (VO)</strong></a> is |
| 84 |
general term for a collection of federated resources that can be used |
| 85 |
to conduct astronomical research, education, and outreach. |
| 86 |
<a name="d:ivoa" id="d:ivoa">The</a> <a href="http://www.ivoa.net/"><strong>International |
| 87 |
Virtual Observatory Alliance (IVOA)</strong></a> is a global |
| 88 |
collaboration of separately funded projects to develop standards and |
| 89 |
infrastructure that enable VO applications.</p> |
| 90 |
<a name="synnot" id="synnot"><h3>Syntax Notation Using XML Schema</h3></a> |
| 91 |
|
| 92 |
<p>The eXtensible Markup Language, or XML, is document syntax for marking |
| 93 |
textual information with named tags and is defined by the |
| 94 |
World Wide Web Consortium (W3C) Recommendation, |
| 95 |
<a href="http://www.w3.org/TR/REC-xml">XML 1.0</a> |
| 96 |
[<a href="#xml">XML</a>]. The set of XML tag names and the syntax |
| 97 |
rules for their use is referred to as the document schema. One way to |
| 98 |
formally define a schema for XML documents is using the W3C standard |
| 99 |
known as XML Schema [<a href="#schema">Schema</a>].</p> |
| 100 |
|
| 101 |
<p> |
| 102 |
This document defines the VOApplication schema using XML Schema. The |
| 103 |
full Schema document is listed in <a href="#appA">Appendix A</a>. |
| 104 |
Parts of the schema appear within the main sections of this document; |
| 105 |
however, documentation nodes have been left out for the sake of brevity. |
| 106 |
</p> |
| 107 |
|
| 108 |
<p> |
| 109 |
Reference to specific elements and types defined in the VOApplication |
| 110 |
schema include the namespaces prefix, <code>va</code>, as in |
| 111 |
<code>va:Application</code> (a type defined in the VOApplication schema). |
| 112 |
Use of the specific <code>va</code> prefix in compliant instance documents is |
| 113 |
not required (the namespace could be assigned to any prefix); its use in this |
| 114 |
document is simply to indicate that it is an entity defined in the |
| 115 |
VOApplication schema. |
| 116 |
<!-- References to (local) elements are further |
| 117 |
labelled by enclosing the name in the XML tag brackets, as in |
| 118 |
<code><vr:identifier></code>. --> |
| 119 |
</p> |
| 120 |
<div class="contents"> |
| 121 |
<h2><a id="contents" name="contents">Contents</a></h2> |
| 122 |
<div class="mmhide_toc" id="toc"><div id="toccnt"> |
| 123 |
<ul><ul> |
| 124 |
<li><a href="#jump1">Introduction</a></li> |
| 125 |
</ul></ul><ul><ul> |
| 126 |
<li><a href="#jump13">The VOApplication Data Model</a></li> |
| 127 |
</ul></ul><ul><ul><ul> |
| 128 |
<li><a href="#jump17">Core VOApplication Metadata</a></li> |
| 129 |
</ul></ul></ul> |
| 130 |
<ul><ul> |
| 131 |
<li><a href="#jump19">Details of the VOApplication Schema </a></li> |
| 132 |
|
| 133 |
</ul></ul><ul><ul> |
| 134 |
<li><a href="#jump25">Appendix A: The complete VOApplication Schema</a></li> |
| 135 |
</ul></ul><ul><ul> |
| 136 |
<li><a href="#jump31">Appendix B: Change History</a></li> |
| 137 |
</ul></ul><ul><ul> |
| 138 |
<li><a href="#jump35">References</a></li> |
| 139 |
</ul></ul> |
| 140 |
</div></div></div> |
| 141 |
<div id="main"> |
| 142 |
<h2><a name="Intro" id="Intro">Introduction</a></h2> |
| 143 |
|
| 144 |
<p> </p> |
| 145 |
|
| 146 |
<h2><a name="model" id="model">The CEA Application Data Model</a></h2> |
| 147 |
<h3>Changes since last version</h3> |
| 148 |
<ul> |
| 149 |
<li>Namespace simplifications resulting from making compliant with VR recommendations</li> |
| 150 |
<li>All of the VR metadata is now included in the application definition, as this is derived directly from the cea:CeaApplication</li> |
| 151 |
<li>ability to add constant parameter to the commandline</li> |
| 152 |
<li>facility to specifying streaming</li> |
| 153 |
</ul> |
| 154 |
<h2>Appendix A: The complete CEAImplementation Schema</h2> |
| 155 |
<p>Note that this schema can be found on-line at <a href="?">http://www.astrogrid.org/schema/CEAImplementation/v1.0rc1</a> (i.e. the target namespace can also be used as a URL for the schema.) This location should represent the definitive source, the schema is only copied below for completeness of this document. </p> |
| 156 |
<div class="schemaOuter"> |
| 157 |
<div class="schemaHeader"><a name="s:VOResource" id="s:VOResource">The Complete CEAImplementation Schema</a></div> |
| 158 |
<div class="schemaInner"> |
| 159 |
<iframe src="ceaImpl/CEAImplementation.xsd" title="VOApplication-v1.0.xsd schema" width="100%">This should be the contents of ceaImpl/CEAImplementation.xsd</iframe> |
| 160 |
</div> |
| 161 |
</div> |
| 162 |
<h2>Appendix B: The complete CEAExecutionRecord Schema</h2> |
| 163 |
<p>Note that this schema can be found on-line at <a href="?">http://www.astrogrid.org/schema/CEAExecutionRecord/v1.0rc1</a> (i.e. the target namespace can also be used as a URL for the schema.) This location should represent the definitive source, the schema is only copied below for completeness of this document. </p> |
| 164 |
<div class="schemaOuter"> |
| 165 |
<div class="schemaHeader"><a name="s:VOResource" id="s:VOResource">The Complete CEAImplementation Schema</a></div> |
| 166 |
<div class="schemaInner"> |
| 167 |
<iframe src="ceaImpl/CEAExecutionRecord.xsd" title="VOApplication-v1.0.xsd schema" width="100%">This should be the contents of ceaImpl/CEAExecutionRecord.xsd</iframe> |
| 168 |
</div> |
| 169 |
</div> |
| 170 |
<a name="appB" id="appB"></a><a name="appB" id="appB"></a> |
| 171 |
<h2>Appendix B: An example CEC Configuration file.</h2> |
| 172 |
<div class="schemaOuter"> |
| 173 |
<div class="schemaHeader">The Complete CEAImplementation instance </div> |
| 174 |
<div class="schemaInner"> |
| 175 |
<iframe src="ceaImpl/SingleCeaApplicationConfig.xml" title="VOCEA-v1.0.xsd schema" width="100%" height="600">This should be the contents of ceaImpl/SingleCeaApplicationConfig.xml</iframe> |
| 176 |
</div> |
| 177 |
</div> |
| 178 |
|
| 179 |
<h2>Appendix d: Change History</h2> |
| 180 |
<p>This is the first version that has been made public - it is derived from wiki content. </p> |
| 181 |
<h2><a id="References">References</a></h2> |
| 182 |
|
| 183 |
<dl> |
| 184 |
<dt> <a name="should" id="should">[RFC 2119]</a> </dt> |
| 185 |
<dd> Bradner, S. 1997. <cite><a href="http://www.ietf.org/rfc/rfc2119.txt"> |
| 186 |
Key words for use in RFCs to Indicate Requirement |
| 187 |
Levels</a></cite>, IETF RFC 2119, |
| 188 |
<code>http://www.ietf.org/rfc/rfc2119.txt</code> </dd> |
| 189 |
|
| 190 |
<dt> <a name="RM" id="RM">[RM]</a> </dt> |
| 191 |
<dd> Hanisch, Robert (ed.) 2004. <cite><a href="http://www.ivoa.net/Documents/REC/ResMetadata/RM-20040426.htm"> Resource Metadata for the Virtual Observatory, Version 1.01</a></cite>, IVOA Recommendation, <code>http://www.ivoa.net/Documents/REC/ResMetadata/RM-20040426.htm</code> </dd> |
| 192 |
<dt> <a name="VR" id="VR">[VR]</a> </dt> |
| 193 |
<dd> Plante, Ray (ed.) 2006. <a href="http://www.ivoa.net/Documents/latest/VOResource.html">VOResource: an XML Encoding Schema for Resource Metadata</a>, IVOA Working Draft, <code>http://www.ivoa.net/Documents/latest/VOResource.html</code></dd> |
| 194 |
<dt> <a name="VSTD" id="VSTD">[VSTD]</a> </dt> |
| 195 |
<dd> Harrison, Paul. (ed.) 2006. <a href="http://www.ivoa.net/Documents/latest/VOStandard.html">VOStandard: an XML Encoding Schema for IVOA Standards</a>, IVOA Working Draft, <code>http://www.ivoa.net/Documents/latest/VOResource.html</code></dd> |
| 196 |
<dt> <a name="CEA" id="CEA">[CEA]</a> </dt> |
| 197 |
<dd> Harrison, Paul. 2006. <a href="http://www.ivoa.net/Documents/latest/CEA.html">A Proposal for a Common Execution Architecture </a>, IVOA Working Draft, <code>http://www.ivoa.net/Documents/latest/CEA.html</code></dd> |
| 198 |
<dt></dt> |
| 199 |
<dt> </dt> |
| 200 |
<dt><a name="CEAPP" id="CEAPP">[CEAAPP]</a> </dt> |
| 201 |
<dd> Harrison, Paul. 2006. <a href="http://www.ivoa.net/Documents/latest/CEAApplicationDM.html">CEA Application Model: A model and XML Encoding Schema for Applications in the Common Execution Architecture</a>, IVOA Working Draft, <code>http://www.ivoa.net/Documents/latest/CEAApplicationDM.html</code></dd> |
| 202 |
<dt><a name="CEAINT" id="CEAINT">[CEAINT]</a> </dt> |
| 203 |
<dd> Harrison, Paul. 2006. <a href="http://www.ivoa.net/Documents/latest/CEAInterface.html">CEA Interface: How to Invoke Applications in the Common Execution Architecture</a>, IVOA Working Draft, <code>http://www.ivoa.net/Documents/latest/CEAInterface.html</code></dd> |
| 204 |
<dt> </dt><dt> <a name="xml" id="xml">[xml]</a> |
| 205 |
</dt><dd> Bray, Tim, Paoli, Jean, Sperberg-McQueen, C. M., Maler, Eve, |
| 206 |
Yergeau, Francois (editors) 2004, |
| 207 |
<cite><a href="http://www.w3.org/TR/REC-xml">Extensible Markup |
| 208 |
Language (XML) 1.0 (Third Edition)</a></cite>, W3C |
| 209 |
<!-- #BeginDate format:En2m -->11-Dec-2006 10:14<!-- #EndDate -->/TR/REC-xml</code> |
| 210 |
|
| 211 |
</dd><dt> <a name="schema" id="schema">[schema]</a> |
| 212 |
</dt><dd> Fallside, David C., Walmsley, Priscilla (editors) 2004, |
| 213 |
<cite><a href="http://www.w3.org/TR/xmlschema-0/">XML Schema |
| 214 |
Part 0: Primer Second Edition</a></cite>, W3C Recommendation 28 |
| 215 |
October 2004, <code>http://www.w3.org/TR/xmlschema-0/</code> |
| 216 |
|
| 217 |
</dd><dt> <a name="iso8601" id="iso8601">[ISO8601]</a> |
| 218 |
</dt><dd> Wolf, Misha and Wicksteed, Charles 1997, |
| 219 |
<cite><a href="http://www.w3.org/TR/NOTE-datetime">Date and |
| 220 |
Time Format</a></cite>, <code>http://www.w3.org/TR/NOTE-datetime</code>. |
| 221 |
|
| 222 |
</dd><dt> <a name="oai" id="oai">[OAI]</a> |
| 223 |
</dt><dd> Lagoze, Carl, Van de Sompel, Herbert, Nelson, Michael, and |
| 224 |
Warner, Simeon 2004, <cite> |
| 225 |
<a href="http://www.openarchives.org/OAI/openarchivesprotocol.html"> |
| 226 |
The Open Archives Initiative Protocol for Metadata Harvesting</a></cite>, |
| 227 |
<code>http://www.openarchives.org/OAI/openarchivesprotocol.html</code>. |
| 228 |
|
| 229 |
</dd><dt> <a name="ID" id="ID">[ID]</a> |
| 230 |
</dt><dd> Plante, R., Linde, T., Williams, R., Noddle, K. 2005, <cite> |
| 231 |
<a href="http://www.ivoa.net/Documents/REC/Identifiers/Identifiers-200505XX.html"> |
| 232 |
IVOA Identifiers v1.1</a></cite>, |
| 233 |
<code>http://www.ivoa.net/Documents/REC/Identifiers/Identifiers-200505XX.html</code>. |
| 234 |
|
| 235 |
</dd><dt> <a name="WSDL" id="WSDL">[WSDL]</a> |
| 236 |
</dt><dd> Christensen, E., Curbera, F., Meredith, G., Weerawarana, S. <cite> |
| 237 |
<a href="http://www.w3.org/TR/wsdl">Web Services Description |
| 238 |
Language (WSDL) 1.1</a></cite>, W3C Note 15 March 2001, |
| 239 |
<code>http://www.w3.org/TR/wsdl</code>. |
| 240 |
|
| 241 |
</dd><dt> <a name="SOAP" id="SOAP">[SOAP]</a> |
| 242 |
</dt><dd> Box, D., Ehnebuske, D., Kakivaya, G., Layman, A., Mendolsohn, |
| 243 |
N., Neilsen, H.F., Thatte, S., Winer, D. <cite> |
| 244 |
<a href="http://www.w3.org/TR/2000/NOTE-SOAP-20000508/"> |
| 245 |
Simple Object Access Protocol (SOAP) 1.1</a></cite>, W3C Note |
| 246 |
08 May 2000, |
| 247 |
<code>http://www.w3.org/TR/2000/NOTE-SOAP-20000508/</code>. |
| 248 |
</dd></dl> |
| 249 |
|
| 250 |
<hr /> |
| 251 |
<font size="-3"> |
| 252 |
<!-- hhmts start --> |
| 253 |
Last modified: |
| 254 |
<!-- #BeginDate format:En2m -->11-Dec-2006 10:14<!-- #EndDate --> |
| 255 |
<!-- hhmts end --> |
| 256 |
</font> |
| 257 |
</div> |
| 258 |
</div> |
| 259 |
</body> |
| 260 |
</html> |
Parent Directory
| 
Revision Log
