Difference: RegUpgradeToV10 (13 vs. 14)

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"
 
This site is powered by the TWiki collaboration platform Powered by Perl This site is powered by the TWiki collaboration platformCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback