Difference: RegUpgradeToV10 (1 vs. 18)

Revision 182012-06-26 - root

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


News

2007 Dec 20
The Registry of Registries is now available for validating and registering your registry. You can also view the currently registered registries. See the Software Tools and Testers section below for more information.

Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

--IVOA.RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry in a Box, v2.0: riabox-2.0rc2.tar.gz
    • Enhancements on the commonly used OAI libraries from Virginia Tech that understands the RI profile on OAI.
    • Allows configuration for compliant OAI responses:
      • returning the Registry VOResource record in Identify response
      • define, document, and configure sets
      • show support for ivo_vor metadata prefix
      • support required oai_dc format with stylesheet from VOResource format.

  • VOResource validating stylesheet: validateVOResource.xsl
    • this style sheet will run VOResource compliance checks that are not covered by the VOResource schemas
    • understands extension types defined in these extension schemas
      • VORegistry
      • VODataService
      • ConeSearch
      • SIA
      • SkyNode
    • By default it will only report on problems found with a text output.
    • Useful optional input parameters include (see in-line documentation for more detail):
      • requireRI: set to 1 if you want to ensure that the VOResource records is wrapped in the <ri:Resource> element as required by the RI standard.
      • rightnow: set to the current date and time (in ISO format) to ensure that all dates are in the past.
      • showStatus: set to "fail warn rec pass" to include reports on passed tests; the default is only to report failures, warnings and recommendations.


META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1 (with bug fixes)" date="1200651715" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="113740" user="RayPlante" version="1.5"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1177926992" name="riabox-2.0rc2.tar.gz" path="riabox-2.0rc2.tar.gz" size="28184" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1180686051" name="RofR-20070601.html" path="RofR-20070601.html" size="28156" user="RayPlante" version="1.3"

Revision 172008-01-18 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


News

2007 Dec 20
The Registry of Registries is now available for validating and registering your registry. You can also view the currently registered registries. See the Software Tools and Testers section below for more information.

Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

--IVOA.RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry in a Box, v2.0: riabox-2.0rc2.tar.gz
    • Enhancements on the commonly used OAI libraries from Virginia Tech that understands the RI profile on OAI.
    • Allows configuration for compliant OAI responses:
      • returning the Registry VOResource record in Identify response
      • define, document, and configure sets
      • show support for ivo_vor metadata prefix
      • support required oai_dc format with stylesheet from VOResource format.

  • VOResource validating stylesheet: validateVOResource.xsl
    • this style sheet will run VOResource compliance checks that are not covered by the VOResource schemas
    • understands extension types defined in these extension schemas
      • VORegistry
      • VODataService
      • ConeSearch
      • SIA
      • SkyNode
    • By default it will only report on problems found with a text output.
    • Useful optional input parameters include (see in-line documentation for more detail):
      • requireRI: set to 1 if you want to ensure that the VOResource records is wrapped in the <ri:Resource> element as required by the RI standard.
      • rightnow: set to the current date and time (in ISO format) to ensure that all dates are in the past.
      • showStatus: set to "fail warn rec pass" to include reports on passed tests; the default is only to report failures, warnings and recommendations.


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
Changed:
<
<
META FILEATTACHMENT attr="" comment="release candidate v1.02R1 (with bug fixes)" date="1184257939" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112432" user="RayPlante" version="1.4"
>
>
META FILEATTACHMENT attr="" comment="release candidate v1.02R1 (with bug fixes)" date="1200651715" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="113740" user="RayPlante" version="1.5"
 
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1177926992" name="riabox-2.0rc2.tar.gz" path="riabox-2.0rc2.tar.gz" size="28184" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1180686051" name="RofR-20070601.html" path="RofR-20070601.html" size="28156" user="RayPlante" version="1.3"

Revision 162007-12-20 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Added:
>
>

News

2007 Dec 20
The Registry of Registries is now available for validating and registering your registry. You can also view the currently registered registries. See the Software Tools and Testers section below for more information.
 

Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

--IVOA.RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry in a Box, v2.0: riabox-2.0rc2.tar.gz
    • Enhancements on the commonly used OAI libraries from Virginia Tech that understands the RI profile on OAI.
    • Allows configuration for compliant OAI responses:
      • returning the Registry VOResource record in Identify response
      • define, document, and configure sets
      • show support for ivo_vor metadata prefix
      • support required oai_dc format with stylesheet from VOResource format.
Changed:
<
<
  • Registry of Registries: Preliminary release
>
>
  • Registry of Registries:
 
Changed:
<
<
>
>
 
  • VOResource validating stylesheet: validateVOResource.xsl
    • this style sheet will run VOResource compliance checks that are not covered by the VOResource schemas
    • understands extension types defined in these extension schemas
      • VORegistry
      • VODataService
      • ConeSearch
      • SIA
      • SkyNode
    • By default it will only report on problems found with a text output.
    • Useful optional input parameters include (see in-line documentation for more detail):
      • requireRI: set to 1 if you want to ensure that the VOResource records is wrapped in the <ri:Resource> element as required by the RI standard.
      • rightnow: set to the current date and time (in ISO format) to ensure that all dates are in the past.
      • showStatus: set to "fail warn rec pass" to include reports on passed tests; the default is only to report failures, warnings and recommendations.


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1 (with bug fixes)" date="1184257939" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112432" user="RayPlante" version="1.4"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1177926992" name="riabox-2.0rc2.tar.gz" path="riabox-2.0rc2.tar.gz" size="28184" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1180686051" name="RofR-20070601.html" path="RofR-20070601.html" size="28156" user="RayPlante" version="1.3"

Revision 152007-10-05 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

Changed:
<
<
java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml
>
>
java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml
  where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

Changed:
<
<
-- RayPlante - 17 April 2007
>
>
--IVOA.RayPlante - 17 April 2007
 

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry in a Box, v2.0: riabox-2.0rc2.tar.gz
    • Enhancements on the commonly used OAI libraries from Virginia Tech that understands the RI profile on OAI.
    • Allows configuration for compliant OAI responses:
      • returning the Registry VOResource record in Identify response
      • define, document, and configure sets
      • show support for ivo_vor metadata prefix
      • support required oai_dc format with stylesheet from VOResource format.

  • VOResource validating stylesheet: validateVOResource.xsl
    • this style sheet will run VOResource compliance checks that are not covered by the VOResource schemas
    • understands extension types defined in these extension schemas
      • VORegistry
      • VODataService
      • ConeSearch
      • SIA
      • SkyNode
    • By default it will only report on problems found with a text output.
    • Useful optional input parameters include (see in-line documentation for more detail):
      • requireRI: set to 1 if you want to ensure that the VOResource records is wrapped in the <ri:Resource> element as required by the RI standard.
      • rightnow: set to the current date and time (in ISO format) to ensure that all dates are in the past.
      • showStatus: set to "fail warn rec pass" to include reports on passed tests; the default is only to report failures, warnings and recommendations.


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1 (with bug fixes)" date="1184257939" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112432" user="RayPlante" version="1.4"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1177926992" name="riabox-2.0rc2.tar.gz" path="riabox-2.0rc2.tar.gz" size="28184" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1180686051" name="RofR-20070601.html" path="RofR-20070601.html" size="28156" user="RayPlante" version="1.3"

Revision 142007-07-12 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

-- RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry in a Box, v2.0: riabox-2.0rc2.tar.gz
    • Enhancements on the commonly used OAI libraries from Virginia Tech that understands the RI profile on OAI.
    • Allows configuration for compliant OAI responses:
      • returning the Registry VOResource record in Identify response
      • define, document, and configure sets
      • show support for ivo_vor metadata prefix
      • support required oai_dc format with stylesheet from VOResource format.

  • VOResource validating stylesheet: validateVOResource.xsl
    • this style sheet will run VOResource compliance checks that are not covered by the VOResource schemas
    • understands extension types defined in these extension schemas
      • VORegistry
      • VODataService
      • ConeSearch
      • SIA
      • SkyNode
    • By default it will only report on problems found with a text output.
    • Useful optional input parameters include (see in-line documentation for more detail):
      • requireRI: set to 1 if you want to ensure that the VOResource records is wrapped in the <ri:Resource> element as required by the RI standard.
      • rightnow: set to the current date and time (in ISO format) to ensure that all dates are in the past.
      • showStatus: set to "fail warn rec pass" to include reports on passed tests; the default is only to report failures, warnings and recommendations.


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
Changed:
<
<
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176774318" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112626" user="RayPlante" version="1.3"
>
>
META FILEATTACHMENT attr="" comment="release candidate v1.02R1 (with bug fixes)" date="1184257939" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112432" user="RayPlante" version="1.4"
 
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1177926992" name="riabox-2.0rc2.tar.gz" path="riabox-2.0rc2.tar.gz" size="28184" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1180686051" name="RofR-20070601.html" path="RofR-20070601.html" size="28156" user="RayPlante" version="1.3"

Revision 132007-06-01 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

-- RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry in a Box, v2.0: riabox-2.0rc2.tar.gz
    • Enhancements on the commonly used OAI libraries from Virginia Tech that understands the RI profile on OAI.
    • Allows configuration for compliant OAI responses:
      • returning the Registry VOResource record in Identify response
      • define, document, and configure sets
      • show support for ivo_vor metadata prefix
      • support required oai_dc format with stylesheet from VOResource format.

  • Registry of Registries: Preliminary release
Changed:
<
<
>
>
Added:
>
>
 

  • VOResource validating stylesheet: validateVOResource.xsl
    • this style sheet will run VOResource compliance checks that are not covered by the VOResource schemas
    • understands extension types defined in these extension schemas
      • VORegistry
      • VODataService
      • ConeSearch
      • SIA
      • SkyNode
    • By default it will only report on problems found with a text output.
    • Useful optional input parameters include (see in-line documentation for more detail):
      • requireRI: set to 1 if you want to ensure that the VOResource records is wrapped in the <ri:Resource> element as required by the RI standard.
      • rightnow: set to the current date and time (in ISO format) to ensure that all dates are in the past.
      • showStatus: set to "fail warn rec pass" to include reports on passed tests; the default is only to report failures, warnings and recommendations.


<--  
-->
Deleted:
<
<

 
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176774318" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112626" user="RayPlante" version="1.3"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1177926992" name="riabox-2.0rc2.tar.gz" path="riabox-2.0rc2.tar.gz" size="28184" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1180686051" name="RofR-20070601.html" path="RofR-20070601.html" size="28156" user="RayPlante" version="1.3"

Revision 122007-06-01 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

-- RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry in a Box, v2.0: riabox-2.0rc2.tar.gz
    • Enhancements on the commonly used OAI libraries from Virginia Tech that understands the RI profile on OAI.
    • Allows configuration for compliant OAI responses:
      • returning the Registry VOResource record in Identify response
      • define, document, and configure sets
      • show support for ivo_vor metadata prefix
      • support required oai_dc format with stylesheet from VOResource format.

  • VOResource validating stylesheet: validateVOResource.xsl
    • this style sheet will run VOResource compliance checks that are not covered by the VOResource schemas
    • understands extension types defined in these extension schemas
      • VORegistry
      • VODataService
      • ConeSearch
      • SIA
      • SkyNode
    • By default it will only report on problems found with a text output.
    • Useful optional input parameters include (see in-line documentation for more detail):
      • requireRI: set to 1 if you want to ensure that the VOResource records is wrapped in the <ri:Resource> element as required by the RI standard.
      • rightnow: set to the current date and time (in ISO format) to ensure that all dates are in the past.
      • showStatus: set to "fail warn rec pass" to include reports on passed tests; the default is only to report failures, warnings and recommendations.


<--  
-->

Added:
>
>
 
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176774318" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112626" user="RayPlante" version="1.3"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1177926992" name="riabox-2.0rc2.tar.gz" path="riabox-2.0rc2.tar.gz" size="28184" user="RayPlante" version="1.1"
Added:
>
>
META FILEATTACHMENT attr="" comment="" date="1180686051" name="RofR-20070601.html" path="RofR-20070601.html" size="28156" user="RayPlante" version="1.3"
 

Revision 112007-05-13 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

-- RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
Changed:
<
<
>
>
 
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry in a Box, v2.0: riabox-2.0rc2.tar.gz
    • Enhancements on the commonly used OAI libraries from Virginia Tech that understands the RI profile on OAI.
    • Allows configuration for compliant OAI responses:
      • returning the Registry VOResource record in Identify response
      • define, document, and configure sets
      • show support for ivo_vor metadata prefix
      • support required oai_dc format with stylesheet from VOResource format.

  • VOResource validating stylesheet: validateVOResource.xsl
    • this style sheet will run VOResource compliance checks that are not covered by the VOResource schemas
    • understands extension types defined in these extension schemas
      • VORegistry
      • VODataService
      • ConeSearch
      • SIA
      • SkyNode
    • By default it will only report on problems found with a text output.
    • Useful optional input parameters include (see in-line documentation for more detail):
      • requireRI: set to 1 if you want to ensure that the VOResource records is wrapped in the <ri:Resource> element as required by the RI standard.
      • rightnow: set to the current date and time (in ISO format) to ensure that all dates are in the past.
      • showStatus: set to "fail warn rec pass" to include reports on passed tests; the default is only to report failures, warnings and recommendations.


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176774318" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112626" user="RayPlante" version="1.3"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1177926992" name="riabox-2.0rc2.tar.gz" path="riabox-2.0rc2.tar.gz" size="28184" user="RayPlante" version="1.1"

Revision 102007-05-04 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

Changed:
<
<
>
>
  More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

-- RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry in a Box, v2.0: riabox-2.0rc2.tar.gz
    • Enhancements on the commonly used OAI libraries from Virginia Tech that understands the RI profile on OAI.
    • Allows configuration for compliant OAI responses:
      • returning the Registry VOResource record in Identify response
      • define, document, and configure sets
      • show support for ivo_vor metadata prefix
      • support required oai_dc format with stylesheet from VOResource format.

  • VOResource validating stylesheet: validateVOResource.xsl
    • this style sheet will run VOResource compliance checks that are not covered by the VOResource schemas
    • understands extension types defined in these extension schemas
      • VORegistry
      • VODataService
      • ConeSearch
      • SIA
      • SkyNode
    • By default it will only report on problems found with a text output.
    • Useful optional input parameters include (see in-line documentation for more detail):
      • requireRI: set to 1 if you want to ensure that the VOResource records is wrapped in the <ri:Resource> element as required by the RI standard.
      • rightnow: set to the current date and time (in ISO format) to ensure that all dates are in the past.
      • showStatus: set to "fail warn rec pass" to include reports on passed tests; the default is only to report failures, warnings and recommendations.


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176774318" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112626" user="RayPlante" version="1.3"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="" date="1177926992" name="riabox-2.0rc2.tar.gz" path="riabox-2.0rc2.tar.gz" size="28184" user="RayPlante" version="1.1"

Revision 92007-04-30 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

-- RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.
Added:
>
>
  • Registry in a Box, v2.0: riabox-2.0rc2.tar.gz
    • Enhancements on the commonly used OAI libraries from Virginia Tech that understands the RI profile on OAI.
    • Allows configuration for compliant OAI responses:
      • returning the Registry VOResource record in Identify response
      • define, document, and configure sets
      • show support for ivo_vor metadata prefix
      • support required oai_dc format with stylesheet from VOResource format.
 
Added:
>
>
      • implemented using Registry-in-a-box above.
 

  • VOResource validating stylesheet: validateVOResource.xsl
    • this style sheet will run VOResource compliance checks that are not covered by the VOResource schemas
    • understands extension types defined in these extension schemas
      • VORegistry
      • VODataService
      • ConeSearch
      • SIA
      • SkyNode
    • By default it will only report on problems found with a text output.
    • Useful optional input parameters include (see in-line documentation for more detail):
      • requireRI: set to 1 if you want to ensure that the VOResource records is wrapped in the <ri:Resource> element as required by the RI standard.
      • rightnow: set to the current date and time (in ISO format) to ensure that all dates are in the past.
      • showStatus: set to "fail warn rec pass" to include reports on passed tests; the default is only to report failures, warnings and recommendations.

Deleted:
<
<

 
<--  
-->
Changed:
<
<
  • : makes compliance checks not covered by XML Schema
>
>
 
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176774318" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112626" user="RayPlante" version="1.3"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"
Added:
>
>
META FILEATTACHMENT attr="" comment="" date="1177926992" name="riabox-2.0rc2.tar.gz" path="riabox-2.0rc2.tar.gz" size="28184" user="RayPlante" version="1.1"
 

Revision 82007-04-26 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

-- RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

Changed:
<
<
    • registration and registry checking coming next.
>
>
Added:
>
>
    • registration coming next.

  • VOResource validating stylesheet: validateVOResource.xsl
    • this style sheet will run VOResource compliance checks that are not covered by the VOResource schemas
    • understands extension types defined in these extension schemas
      • VORegistry
      • VODataService
      • ConeSearch
      • SIA
      • SkyNode
    • By default it will only report on problems found with a text output.
    • Useful optional input parameters include (see in-line documentation for more detail):
      • requireRI: set to 1 if you want to ensure that the VOResource records is wrapped in the <ri:Resource> element as required by the RI standard.
      • rightnow: set to the current date and time (in ISO format) to ensure that all dates are in the past.
      • showStatus: set to "fail warn rec pass" to include reports on passed tests; the default is only to report failures, warnings and recommendations.
 


<--  
-->
Changed:
<
<
>
>
  • : makes compliance checks not covered by XML Schema
 
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176774318" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112626" user="RayPlante" version="1.3"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"

Revision 72007-04-26 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

-- RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry of Registries: Preliminary release


<--  
-->
Added:
>
>
 
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176774318" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112626" user="RayPlante" version="1.3"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
Added:
>
>
META FILEATTACHMENT attr="" comment="makes compliance checks not covered by XML Schema" date="1177578267" name="validateVOResource.xsl" path="validateVOResource.xsl" size="31089" user="RayPlante" version="1.1"
 

Revision 62007-04-17 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Added:
>
>
Note: The samples above were created to be compliant only with the VOResource schema and the above extensions. These would have a different wrapping or "root" element (namely, the <ri:Resource> element) when used as part of a Registry service, the details depending on the type of message; see the RI spec for specifics. (I'll try to update these with Registry-specific versions to avoid confusion --rp)
  Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

-- RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry of Registries: Preliminary release


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176774318" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112626" user="RayPlante" version="1.3"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"

Revision 52007-04-17 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.

-- RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry of Registries: Preliminary release


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
Changed:
<
<
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176773018" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112504" user="RayPlante" version="1.2"
>
>
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176774318" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112626" user="RayPlante" version="1.3"
 
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"

Revision 42007-04-17 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

Changed:
<
<
See VoResourceConversionXSL for more info, including Caveats and a list of recent changes.
>
>
See VoResourceConversionXSL for more info, including Caveats, available input parameters, and a list of recent changes.
  -- RayPlante - 17 April 2007

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry of Registries: Preliminary release


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
Changed:
<
<
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770027" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="109163" user="RayPlante" version="1.1"
>
>
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1176773018" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="112504" user="RayPlante" version="1.2"
 
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"

Revision 32007-04-17 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

Changed:
<
<
Caveats
>
>
See VoResourceConversionXSL for more info, including Caveats and a list of recent changes.
Deleted:
<
<
  • If you notice any problems let RayPlante know
  • I have not yet plugged in support for CEA
  • When you process a registry record, a warning message is generated indicating that you must update certain information "by hand".
  • The created and updated attributes are now required by the VOResource core schema; if they are not set in the input document, a dummy value will be inserted and a warning message generated.
 
Changed:
<
<
An update of the earlier released XSLTv1.0 stylesheet is also available; however, it does not set namespace declarations properly.
>
>
-- RayPlante - 17 April 2007
Deleted:
<
<
-- RayPlante - 31 Oct 2006

VoResourceConversionXSL

 

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry of Registries: Preliminary release


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770027" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="109163" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"

Revision 22007-04-17 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

Caveats

  • If you notice any problems let RayPlante know
  • I have not yet plugged in support for CEA
  • When you process a registry record, a warning message is generated indicating that you must update certain information "by hand".
  • The created and updated attributes are now required by the VOResource core schema; if they are not set in the input document, a dummy value will be inserted and a warning message generated.

An update of the earlier released XSLTv1.0 stylesheet is also available; however, it does not set namespace declarations properly.

-- RayPlante - 31 Oct 2006

Added:
>
>
VoResourceConversionXSL
 

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry of Registries: Preliminary release


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770027" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="109163" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"

Revision 12007-04-05 - RayPlante

 
META TOPICPARENT name="RegistryImplmentation"
Jumps: reg-dm mail archive :: ResourceMetadata :: RegistryInterface :: VOResourceV10 :: RegDMServices :: RegUpgradeSummer2006
Meetings: InterOpMay2006ResReg :: InterOpSep2006ResReg

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents


Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

Action When Comments
updated versions schemas done see schema section below
updated draft of RI spec done see attachments at RegistryInterface
conversion stylesheet available done see below
Registry of Registries ready 06-Apr-2007 (Ray)
complete implementations of RI v1.0 30-Apr-2007  
general testing period begins 01-May-2007  
discuss remaining interoperability issues at IVOA mtg. 14-May-2007  
new registries "turned on" 01-Jun-2007  
achieve stability 15-Jun-2007  

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Schema Sample instances
VOResource-v1.0.xsd organisation.xml
webform.xml
webservice.xml
VODataService-v1.0.xsd collection.xml
catalog.xml
stc.xml
ConeSearch-v1.0.xsd conesearch.xml
SIA-v1.0.xsd sia.xml
sia2ver.xml
VORegistry-v1.0.xsd registry.xml
VOStandard-v0.1.xsd siastd.xml
OpenSkyNode-v0.2.xsd skynode.xml

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2
XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

Caveats

  • If you notice any problems let RayPlante know
  • I have not yet plugged in support for CEA
  • When you process a registry record, a warning message is generated indicating that you must update certain information "by hand".
  • The created and updated attributes are now required by the VOResource core schema; if they are not set in the input document, a dummy value will be inserted and a warning message generated.

An update of the earlier released XSLTv1.0 stylesheet is also available; however, it does not set namespace declarations properly.

-- RayPlante - 31 Oct 2006

Software Tools and Testers

  • ivoaregistry: a registry search Java library and tester.
    • Download as a zip file: ireg-linux.zip
      • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
      • It is pre-built, but can be re-built with ant
      • Requires at least Java 1.5
    • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
    • The regsearch command line tool can be used to test the interface
      • to install, first run "bin/install_tools"
      • see top section of bin/regsearch for usage details
      • it's still a little clunky for using in scripts.

  • Registry of Registries: Preliminary release


<--  
-->

META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769093" name="VOResource-v1.0.tar.gz" path="VOResource-v1.0.tar.gz" size="52280" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769144" name="catalog.xml" path="catalog.xml" size="8071" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769163" name="collection.xml" path="collection.xml" size="5021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769175" name="ConeSearch-v1.0.xsd" path="ConeSearch-v1.0.xsd" size="7617" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769190" name="conesearch.xml" path="conesearch.xml" size="3631" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769227" name="ivoa-auth.xml" path="ivoa-auth.xml" size="1550" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769328" name="ivoa.xml" path="ivoa.xml" size="3362" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769357" name="organisation.xml" path="organisation.xml" size="1966" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769385" name="registry.xml" path="registry.xml" size="3182" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769402" name="rofr.xml" path="rofr.xml" size="2608" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769423" name="sia2ver.xml" path="sia2ver.xml" size="4216" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769446" name="siastd.xml" path="siastd.xml" size="6222" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769467" name="SIA-v1.0.xsd" path="SIA-v1.0.xsd" size="14185" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769488" name="sia.xml" path="sia.xml" size="7994" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769510" name="SkyNode-v0.2.xsd" path="SkyNode-v0.2.xsd" size="7128" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769535" name="stc-v1.30.xsd" path="stc-v1.30.xsd" size="164532" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769563" name="stc.xml" path="stc.xml" size="2574" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769587" name="VODataService-v1.0.xsd" path="VODataService-v1.0.xsd" size="35021" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769610" name="VORegistry-v1.0.xsd" path="VORegistry-v1.0.xsd" size="11415" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769635" name="VOResource-v1.0.xsd" path="VOResource-v1.0.xsd" size="54369" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769654" name="VOStandard-v0.1.xsd" path="VOStandard-v0.1.xsd" size="5948" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769689" name="webform.xml" path="webform.xml" size="1920" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175769709" name="webservice.xml" path="webservice.xml" size="2601" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770027" name="VOResource-v0.10-v1.0.xsl2" path="VOResource-v0.10-v1.0.xsl2" size="109163" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="release candidate v1.02R1" date="1175770509" name="VOResource-v1.0.zip" path="VOResource-v1.0.zip" size="66276" user="RayPlante" version="1.1"
 
This site is powered by the TWiki collaboration platform Powered by Perl This site is powered by the TWiki collaboration platformCopyright © 2008-2022 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback