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.


Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatxsd ConeSearch-v1.0.xsd r1 manage 7.4 K 2007-04-05 - 10:32 RayPlante release candidate v1.02R1
HTMLhtml RofR-20070601.html r3 r2 r1 manage 27.5 K 2007-06-01 - 08:20 RayPlante  
Unknown file formatxsd SIA-v1.0.xsd r1 manage 13.9 K 2007-04-05 - 10:37 RayPlante release candidate v1.02R1
Unknown file formatxsd SkyNode-v0.2.xsd r1 manage 7.0 K 2007-04-05 - 10:38 RayPlante release candidate v1.02R1
Unknown file formatxsd VODataService-v1.0.xsd r1 manage 34.2 K 2007-04-05 - 10:39 RayPlante release candidate v1.02R1
Unknown file formatxsd VORegistry-v1.0.xsd r1 manage 11.1 K 2007-04-05 - 10:40 RayPlante release candidate v1.02R1
Unknown file formatxsl2 VOResource-v0.10-v1.0.xsl2 r5 r4 r3 r2 r1 manage 111.1 K 2008-01-18 - 10:21 RayPlante release candidate v1.02R1 (with bug fixes)
Unknown file formatgz VOResource-v1.0.tar.gz r1 manage 51.1 K 2007-04-05 - 10:31 RayPlante release candidate v1.02R1
Unknown file formatxsd VOResource-v1.0.xsd r1 manage 53.1 K 2007-04-05 - 10:40 RayPlante release candidate v1.02R1
Compressed Zip archivezip VOResource-v1.0.zip r1 manage 64.7 K 2007-04-05 - 10:55 RayPlante release candidate v1.02R1
Unknown file formatxsd VOStandard-v0.1.xsd r1 manage 5.8 K 2007-04-05 - 10:40 RayPlante release candidate v1.02R1
XMLxml catalog.xml r1 manage 7.9 K 2007-04-05 - 10:32 RayPlante release candidate v1.02R1
XMLxml collection.xml r1 manage 4.9 K 2007-04-05 - 10:32 RayPlante release candidate v1.02R1
XMLxml conesearch.xml r1 manage 3.5 K 2007-04-05 - 10:33 RayPlante release candidate v1.02R1
XMLxml ivoa-auth.xml r1 manage 1.5 K 2007-04-05 - 10:33 RayPlante release candidate v1.02R1
XMLxml ivoa.xml r1 manage 3.3 K 2007-04-05 - 10:35 RayPlante release candidate v1.02R1
XMLxml organisation.xml r1 manage 1.9 K 2007-04-05 - 10:35 RayPlante release candidate v1.02R1
XMLxml registry.xml r1 manage 3.1 K 2007-04-05 - 10:36 RayPlante release candidate v1.02R1
Unknown file formatgz riabox-2.0rc2.tar.gz r1 manage 27.5 K 2007-04-30 - 09:56 RayPlante  
XMLxml rofr.xml r1 manage 2.5 K 2007-04-05 - 10:36 RayPlante release candidate v1.02R1
XMLxml sia.xml r1 manage 7.8 K 2007-04-05 - 10:38 RayPlante release candidate v1.02R1
XMLxml sia2ver.xml r1 manage 4.1 K 2007-04-05 - 10:37 RayPlante release candidate v1.02R1
XMLxml siastd.xml r1 manage 6.1 K 2007-04-05 - 10:37 RayPlante release candidate v1.02R1
Unknown file formatxsd stc-v1.30.xsd r1 manage 160.7 K 2007-04-05 - 10:38 RayPlante release candidate v1.02R1
XMLxml stc.xml r1 manage 2.5 K 2007-04-05 - 10:39 RayPlante release candidate v1.02R1
XSL (XML style sheet)xsl validateVOResource.xsl r1 manage 30.4 K 2007-04-26 - 09:04 RayPlante makes compliance checks not covered by XML Schema
XMLxml webform.xml r1 manage 1.9 K 2007-04-05 - 10:41 RayPlante release candidate v1.02R1
XMLxml webservice.xml r1 manage 2.5 K 2007-04-05 - 10:41 RayPlante release candidate v1.02R1
Edit | Attach | Watch | Print version | History: r17 < r16 < r15 < r14 < r13 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r17 - 2008-01-18 - RayPlante
 
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