Difference: GettingIntoTheRegistry (1 vs. 10)

Revision 102023-11-20 - MarkusDemleitner

 
META TOPICPARENT name="IvoaResReg"
The Registry is the collection of metadata on the services in the Virtual Observatory. See IvoaResReg for more information about why you want your service in.

Registering a service requires two steps:

  1. create a resource record (this means producing an XML document valid according to a schema called VOResource; example)
  2. add the new resource record to the Registry (which in the end means that someone, possibly you, will have to offer your record through a protocol called OAI-PMH).
There are several different ways to do that; which one is the right for you depends, in particular, on how many services you want to register and how often their descriptions are expected to change (yes, you should keep your Registry entries up to date...). Below, we discuss three options:

  • Use a web browser (best if you have only very few and rarely changing records)
  • Use purx (best if you can machine-generate your resource records but only have a dozen or so resources)
  • Run a publishing registry (all other cases)
Added:
>
>
In all three cases, note that the searchable registries (which are what clients generally use), it takes about a day for them to notice any changes you make. For the Heidelberg RegTAP registry that is used by many clients, you can speed up re-harvesting by using the harvest trigger.
 

Choosing an authority identifier

Unless you use purx, you will first have to choose an authority identifier.

That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.

Consider, however, that the authority identifiers must be globally unique. The web interfaces won't let you create an authority that's already taken, but please don't be too generic (“astro” or “star” for instance, would probably not be appropriate authority identifiers).

Once you have chosen an authority id, make sure it is not taken already. The Registry contains a resource record for every authority taken, so this can be established by querying the Registry itself. You can use a WIRR query to do that (replace "org.gavo.dc" with what your new authority id in the form above).

With the browser interfaces discussed below, your authority id will be your login, and the services will claim the authority for you.

When, on the other hand, you run run your own publishing registry, the record for your authority should be the first thing you publish (that's “claiming the authority”). You can start from a ( sample record to write the record.

Registration with a web browser

To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by using ESAVO. This is sufficient if all you want is just register a handful of resources that change rarely, if ever.

A little walkthrough of the process was given at the first ASTERICS European Data Provider Forum.

Added:
>
>
To make the harvest trigger pull your changes, use ivo://esavo/registry in “Registry's ivoid”.
 

Registration via purx

Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a “proxy” (to the rest of the Registry) service to that URL; the only such proxy service available right now is at http://dc.g-vo.org/purx/q/enroll/custom.

Writing valid (and search-friendly) VOResource documents isn't trivial, so you will very typically start from example records or rely on publishing software to generate them.

Most of this (including links to sample records) is explained on PURX' info page: http://dc.g-vo.org/purx/q/enroll/info.

Added:
>
>
To make the harvest trigger pull your changes, use ivo://purx/registry in “Registry's ivoid”; however, there is no way to force purx to look at your record again. Complain to gavo@ari.uni-heidelberg.de if this bites you.
 

Run a publishing registry

If you have many (say, 10 or more) resources to register, or if these change often, you should definitely run your own publishing Registry. Some publication software has code to do that built in; if you run something else, ask around on the registry mailing list, as multiple data centres have already implemented at least the OAI-PMH part. Even when running off-the-shelve software, at least skim the underlying VO standard, Registry Interfaces, to have an idea of how all this is supposed to work togeter.

Changed:
<
<
With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so. Incidentally, for the Heidelberg RegTAP registry that is used by many clients, you can speed up re-harvesting by using the harvest trigger.
>
>
With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so.
  If you want or have to write your own software to produce VOResource and/or speak OAI-PMH, here are some pointers:

Added:
>
>
 
<--  
-->
Deleted:
<
<

Revision 92023-05-13 - MarkusDemleitner

 
META TOPICPARENT name="IvoaResReg"
The Registry is the collection of metadata on the services in the Virtual Observatory. See IvoaResReg for more information about why you want your service in.

Registering a service requires two steps:

  1. create a resource record (this means producing an XML document valid according to a schema called VOResource; example)
  2. add the new resource record to the Registry (which in the end means that someone, possibly you, will have to offer your record through a protocol called OAI-PMH).
There are several different ways to do that; which one is the right for you depends, in particular, on how many services you want to register and how often their descriptions are expected to change (yes, you should keep your Registry entries up to date...). Below, we discuss three options:

  • Use a web browser (best if you have only very few and rarely changing records)
Changed:
<
<
  • Use purx (best if you can machine-generate your resource records but only have a dozen or so resources)
>
>
  • Use purx (best if you can machine-generate your resource records but only have a dozen or so resources)
 
  • Run a publishing registry (all other cases)

Choosing an authority identifier

Unless you use purx, you will first have to choose an authority identifier.

That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.

Consider, however, that the authority identifiers must be globally unique. The web interfaces won't let you create an authority that's already taken, but please don't be too generic (“astro” or “star” for instance, would probably not be appropriate authority identifiers).

Once you have chosen an authority id, make sure it is not taken already. The Registry contains a resource record for every authority taken, so this can be established by querying the Registry itself. You can use a WIRR query to do that (replace "org.gavo.dc" with what your new authority id in the form above).

With the browser interfaces discussed below, your authority id will be your login, and the services will claim the authority for you.

When, on the other hand, you run run your own publishing registry, the record for your authority should be the first thing you publish (that's “claiming the authority”). You can start from a ( sample record to write the record.

Registration with a web browser

To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by using ESAVO. This is sufficient if all you want is just register a handful of resources that change rarely, if ever.

A little walkthrough of the process was given at the first ASTERICS European Data Provider Forum.

Registration via purx

Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a “proxy” (to the rest of the Registry) service to that URL; the only such proxy service available right now is at http://dc.g-vo.org/purx/q/enroll/custom.

Writing valid (and search-friendly) VOResource documents isn't trivial, so you will very typically start from example records or rely on publishing software to generate them.

Most of this (including links to sample records) is explained on PURX' info page: http://dc.g-vo.org/purx/q/enroll/info.

Run a publishing registry

If you have many (say, 10 or more) resources to register, or if these change often, you should definitely run your own publishing Registry. Some publication software has code to do that built in; if you run something else, ask around on the registry mailing list, as multiple data centres have already implemented at least the OAI-PMH part. Even when running off-the-shelve software, at least skim the underlying VO standard, Registry Interfaces, to have an idea of how all this is supposed to work togeter.

Changed:
<
<
With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so.
>
>
With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so. Incidentally, for the Heidelberg RegTAP registry that is used by many clients, you can speed up re-harvesting by using the harvest trigger.
  If you want or have to write your own software to produce VOResource and/or speak OAI-PMH, here are some pointers:

<--  
-->
Added:
>
>

Revision 82023-05-11 - TomDonaldson

 
META TOPICPARENT name="IvoaResReg"
The Registry is the collection of metadata on the services in the Virtual Observatory. See IvoaResReg for more information about why you want your service in.

Registering a service requires two steps:

  1. create a resource record (this means producing an XML document valid according to a schema called VOResource; example)
  2. add the new resource record to the Registry (which in the end means that someone, possibly you, will have to offer your record through a protocol called OAI-PMH).
There are several different ways to do that; which one is the right for you depends, in particular, on how many services you want to register and how often their descriptions are expected to change (yes, you should keep your Registry entries up to date...). Below, we discuss three options:

  • Use a web browser (best if you have only very few and rarely changing records)
  • Use purx (best if you can machine-generate your resource records but only have a dozen or so resources)
  • Run a publishing registry (all other cases)

Choosing an authority identifier

Unless you use purx, you will first have to choose an authority identifier.

Changed:
<
<
That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.
>
>
That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.
 
Changed:
<
<
Consider, however, that the authority identifiers must be globally unique. The web interfaces won't let you create an authority that's already taken, but please don't be too generic (“astro” or “star” for instance, would probably not be appropriate authority identifiers).
>
>
Consider, however, that the authority identifiers must be globally unique. The web interfaces won't let you create an authority that's already taken, but please don't be too generic (“astro” or “star” for instance, would probably not be appropriate authority identifiers).
  Once you have chosen an authority id, make sure it is not taken already. The Registry contains a resource record for every authority taken, so this can be established by querying the Registry itself. You can use a WIRR query to do that (replace "org.gavo.dc" with what your new authority id in the form above).

With the browser interfaces discussed below, your authority id will be your login, and the services will claim the authority for you.

Changed:
<
<
When, on the other hand, you run run your own publishing registry, the record for your authority should be the first thing you publish (that's “claiming the authority”). You can start from a (sample record to write the record.
>
>
When, on the other hand, you run run your own publishing registry, the record for your authority should be the first thing you publish (that's “claiming the authority”). You can start from a ( sample record to write the record.
 

Registration with a web browser

Changed:
<
<
To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose whatever interface you consider nicer). This is sufficient if all you want is just register a handful of resources that change rarely, if ever.
>
>
To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by using ESAVO. This is sufficient if all you want is just register a handful of resources that change rarely, if ever.
  A little walkthrough of the process was given at the first ASTERICS European Data Provider Forum.

Registration via purx

Changed:
<
<
Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a “proxy” (to the rest of the Registry) service to that URL; the only such proxy service available right now is at http://dc.g-vo.org/purx/q/enroll/custom.
>
>
Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a “proxy” (to the rest of the Registry) service to that URL; the only such proxy service available right now is at http://dc.g-vo.org/purx/q/enroll/custom.
  Writing valid (and search-friendly) VOResource documents isn't trivial, so you will very typically start from example records or rely on publishing software to generate them.

Most of this (including links to sample records) is explained on PURX' info page: http://dc.g-vo.org/purx/q/enroll/info.

Run a publishing registry

If you have many (say, 10 or more) resources to register, or if these change often, you should definitely run your own publishing Registry. Some publication software has code to do that built in; if you run something else, ask around on the registry mailing list, as multiple data centres have already implemented at least the OAI-PMH part. Even when running off-the-shelve software, at least skim the underlying VO standard, Registry Interfaces, to have an idea of how all this is supposed to work togeter.

Changed:
<
<
With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so.
>
>
With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so.
  If you want or have to write your own software to produce VOResource and/or speak OAI-PMH, here are some pointers:
Changed:
<
<
>
>
 
<--  
-->

Revision 72022-03-31 - MarkusDemleitner

 
META TOPICPARENT name="IvoaResReg"
The Registry is the collection of metadata on the services in the Virtual Observatory. See IvoaResReg for more information about why you want your service in.

Registering a service requires two steps:

  1. create a resource record (this means producing an XML document valid according to a schema called VOResource; example)
  2. add the new resource record to the Registry (which in the end means that someone, possibly you, will have to offer your record through a protocol called OAI-PMH).
There are several different ways to do that; which one is the right for you depends, in particular, on how many services you want to register and how often their descriptions are expected to change (yes, you should keep your Registry entries up to date...). Below, we discuss three options:

  • Use a web browser (best if you have only very few and rarely changing records)
  • Use purx (best if you can machine-generate your resource records but only have a dozen or so resources)
  • Run a publishing registry (all other cases)

Choosing an authority identifier

Unless you use purx, you will first have to choose an authority identifier.

That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.

Consider, however, that the authority identifiers must be globally unique. The web interfaces won't let you create an authority that's already taken, but please don't be too generic (“astro” or “star” for instance, would probably not be appropriate authority identifiers).

Once you have chosen an authority id, make sure it is not taken already. The Registry contains a resource record for every authority taken, so this can be established by querying the Registry itself. You can use a WIRR query to do that (replace "org.gavo.dc" with what your new authority id in the form above).

With the browser interfaces discussed below, your authority id will be your login, and the services will claim the authority for you.

When, on the other hand, you run run your own publishing registry, the record for your authority should be the first thing you publish (that's “claiming the authority”). You can start from a (sample record to write the record.

Registration with a web browser

To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose whatever interface you consider nicer). This is sufficient if all you want is just register a handful of resources that change rarely, if ever.

A little walkthrough of the process was given at the first ASTERICS European Data Provider Forum.

Registration via purx

Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a “proxy” (to the rest of the Registry) service to that URL; the only such proxy service available right now is at http://dc.g-vo.org/purx/q/enroll/custom.

Writing valid (and search-friendly) VOResource documents isn't trivial, so you will very typically start from example records or rely on publishing software to generate them.

Most of this (including links to sample records) is explained on PURX' info page: http://dc.g-vo.org/purx/q/enroll/info.

Run a publishing registry

Changed:
<
<
If you have many (say, 10 or more) resources to register, of if these change often, you should definitely run your own publishing Registry. Some publication software has code to do that built in; if you run something else, ask around on the registry mailing list, as multiple data centres have already implemented at least the OAI-PMH part. Even when running off-the-shelve software, at least skim the underlying VO standard, Registry Interfaces, to have an idea of how all this is supposed to work togeter.
>
>
If you have many (say, 10 or more) resources to register, or if these change often, you should definitely run your own publishing Registry. Some publication software has code to do that built in; if you run something else, ask around on the registry mailing list, as multiple data centres have already implemented at least the OAI-PMH part. Even when running off-the-shelve software, at least skim the underlying VO standard, Registry Interfaces, to have an idea of how all this is supposed to work togeter.
  With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so.

If you want or have to write your own software to produce VOResource and/or speak OAI-PMH, here are some pointers:

<--  
-->

Revision 62022-03-28 - MarkusDemleitner

 
META TOPICPARENT name="IvoaResReg"
The Registry is the collection of metadata on the services in the Virtual Observatory. See IvoaResReg for more information about why you want your service in.

Registering a service requires two steps:

  1. create a resource record (this means producing an XML document valid according to a schema called VOResource; example)
  2. add the new resource record to the Registry (which in the end means that someone, possibly you, will have to offer your record through a protocol called OAI-PMH).
There are several different ways to do that; which one is the right for you depends, in particular, on how many services you want to register and how often their descriptions are expected to change (yes, you should keep your Registry entries up to date...). Below, we discuss three options:

  • Use a web browser (best if you have only very few and rarely changing records)
  • Use purx (best if you can machine-generate your resource records but only have a dozen or so resources)
  • Run a publishing registry (all other cases)

Choosing an authority identifier

Unless you use purx, you will first have to choose an authority identifier.

That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.

Consider, however, that the authority identifiers must be globally unique. The web interfaces won't let you create an authority that's already taken, but please don't be too generic (“astro” or “star” for instance, would probably not be appropriate authority identifiers).

Once you have chosen an authority id, make sure it is not taken already. The Registry contains a resource record for every authority taken, so this can be established by querying the Registry itself. You can use a WIRR query to do that (replace "org.gavo.dc" with what your new authority id in the form above).

With the browser interfaces discussed below, your authority id will be your login, and the services will claim the authority for you.

When, on the other hand, you run run your own publishing registry, the record for your authority should be the first thing you publish (that's “claiming the authority”). You can start from a (sample record to write the record.

Registration with a web browser

Changed:
<
<
To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose whatever interface you consider nicer). This is sufficient if all you want is just register a handful of resources.
>
>
To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose whatever interface you consider nicer). This is sufficient if all you want is just register a handful of resources that change rarely, if ever.
  A little walkthrough of the process was given at the first ASTERICS European Data Provider Forum.

Registration via purx

Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a “proxy” (to the rest of the Registry) service to that URL; the only such proxy service available right now is at http://dc.g-vo.org/purx/q/enroll/custom.

Writing valid (and search-friendly) VOResource documents isn't trivial, so you will very typically start from example records or rely on publishing software to generate them.

Most of this (including links to sample records) is explained on PURX' info page: http://dc.g-vo.org/purx/q/enroll/info.

Run a publishing registry

Changed:
<
<
Even if your software has built-in support for OAI-PMH, the protocol behind information exchange within the Registry, running a publishing registry makes you part of a fairly complex, distributed bibliographic database; in particular, you'll be causing the VO's curators quite a bit of work if you later decide to not bother any more and just let the thing rot.
>
>
If you have many (say, 10 or more) resources to register, of if these change often, you should definitely run your own publishing Registry. Some publication software has code to do that built in; if you run something else, ask around on the registry mailing list, as multiple data centres have already implemented at least the OAI-PMH part. Even when running off-the-shelve software, at least skim the underlying VO standard, Registry Interfaces, to have an idea of how all this is supposed to work togeter.
Deleted:
<
<
So, before you go down this road, ensure that the other two options won't work for you. Also, you should at least have had a brief look at the underlying VO standard, Registry Interfaces.

Having said that, OAI-PMH is not overly hard to implement, and starting from examples, writing VOResource records from whatever metadata you have isn't rocket science either. Also, some software (e.g., DaCHS) has built-in support for both VOResource and OAI-PMH), so once you're wrapped your head around what an authority is (see above), it's not so bad.

  With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so.

If you want or have to write your own software to produce VOResource and/or speak OAI-PMH, here are some pointers:

<--  
-->

Revision 52021-07-15 - KostandinVrioni

 
META TOPICPARENT name="IvoaResReg"
The Registry is the collection of metadata on the services in the Virtual Observatory. See IvoaResReg for more information about why you want your service in.

Registering a service requires two steps:

  1. create a resource record (this means producing an XML document valid according to a schema called VOResource; example)
  2. add the new resource record to the Registry (which in the end means that someone, possibly you, will have to offer your record through a protocol called OAI-PMH).
There are several different ways to do that; which one is the right for you depends, in particular, on how many services you want to register and how often their descriptions are expected to change (yes, you should keep your Registry entries up to date...). Below, we discuss three options:

  • Use a web browser (best if you have only very few and rarely changing records)
  • Use purx (best if you can machine-generate your resource records but only have a dozen or so resources)
  • Run a publishing registry (all other cases)

Choosing an authority identifier

Unless you use purx, you will first have to choose an authority identifier.

That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.

Consider, however, that the authority identifiers must be globally unique. The web interfaces won't let you create an authority that's already taken, but please don't be too generic (“astro” or “star” for instance, would probably not be appropriate authority identifiers).

Once you have chosen an authority id, make sure it is not taken already. The Registry contains a resource record for every authority taken, so this can be established by querying the Registry itself. You can use a WIRR query to do that (replace "org.gavo.dc" with what your new authority id in the form above).

With the browser interfaces discussed below, your authority id will be your login, and the services will claim the authority for you.

When, on the other hand, you run run your own publishing registry, the record for your authority should be the first thing you publish (that's “claiming the authority”). You can start from a (sample record to write the record.

Registration with a web browser

Changed:
<
<
To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose whatever interface you consider nicer). This is sufficient if all you want is just register a handful of resources.
>
>
To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose whatever interface you consider nicer). This is sufficient if all you want is just register a handful of resources.
  A little walkthrough of the process was given at the first ASTERICS European Data Provider Forum.

Registration via purx

Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a “proxy” (to the rest of the Registry) service to that URL; the only such proxy service available right now is at http://dc.g-vo.org/purx/q/enroll/custom.

Writing valid (and search-friendly) VOResource documents isn't trivial, so you will very typically start from example records or rely on publishing software to generate them.

Most of this (including links to sample records) is explained on PURX' info page: http://dc.g-vo.org/purx/q/enroll/info.

Run a publishing registry

Even if your software has built-in support for OAI-PMH, the protocol behind information exchange within the Registry, running a publishing registry makes you part of a fairly complex, distributed bibliographic database; in particular, you'll be causing the VO's curators quite a bit of work if you later decide to not bother any more and just let the thing rot.

So, before you go down this road, ensure that the other two options won't work for you. Also, you should at least have had a brief look at the underlying VO standard, Registry Interfaces.

Having said that, OAI-PMH is not overly hard to implement, and starting from examples, writing VOResource records from whatever metadata you have isn't rocket science either. Also, some software (e.g., DaCHS) has built-in support for both VOResource and OAI-PMH), so once you're wrapped your head around what an authority is (see above), it's not so bad.

With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so.

If you want or have to write your own software to produce VOResource and/or speak OAI-PMH, here are some pointers:

<--  
-->

Revision 42020-11-20 - TheresaDower

 
META TOPICPARENT name="IvoaResReg"
The Registry is the collection of metadata on the services in the Virtual Observatory. See IvoaResReg for more information about why you want your service in.

Registering a service requires two steps:

  1. create a resource record (this means producing an XML document valid according to a schema called VOResource; example)
  2. add the new resource record to the Registry (which in the end means that someone, possibly you, will have to offer your record through a protocol called OAI-PMH).
There are several different ways to do that; which one is the right for you depends, in particular, on how many services you want to register and how often their descriptions are expected to change (yes, you should keep your Registry entries up to date...). Below, we discuss three options:

  • Use a web browser (best if you have only very few and rarely changing records)
  • Use purx (best if you can machine-generate your resource records but only have a dozen or so resources)
  • Run a publishing registry (all other cases)

Choosing an authority identifier

Unless you use purx, you will first have to choose an authority identifier.

That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.

Consider, however, that the authority identifiers must be globally unique. The web interfaces won't let you create an authority that's already taken, but please don't be too generic (“astro” or “star” for instance, would probably not be appropriate authority identifiers).

Changed:
<
<
Once you have chosen an authority id, make sure it is not taken already. The Registry contains a resource record for every authority taken, so this can be established by querying the Registry itself. You can use a WIRR query to do that (replace "org.gavo.dc" with what your new authority id in the form above).
>
>
Once you have chosen an authority id, make sure it is not taken already. The Registry contains a resource record for every authority taken, so this can be established by querying the Registry itself. You can use a WIRR query to do that (replace "org.gavo.dc" with what your new authority id in the form above).
  With the browser interfaces discussed below, your authority id will be your login, and the services will claim the authority for you.
Changed:
<
<
When, on the other hand, you run run your own publishing registry, the record for your authority should be the first thing you publish (that's “claiming the authority”). You can start from a (sample record to write the record.
>
>
When, on the other hand, you run run your own publishing registry, the record for your authority should be the first thing you publish (that's “claiming the authority”). You can start from a (sample record to write the record.
 
Deleted:
<
<
 

Registration with a web browser

Changed:
<
<
To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose whatever interface you consider nicer). This is sufficient if all you want is just register a handful of resources.
>
>
To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose whatever interface you consider nicer). This is sufficient if all you want is just register a handful of resources.
  A little walkthrough of the process was given at the first ASTERICS European Data Provider Forum.

Registration via purx

Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a “proxy” (to the rest of the Registry) service to that URL; the only such proxy service available right now is at http://dc.g-vo.org/purx/q/enroll/custom.

Writing valid (and search-friendly) VOResource documents isn't trivial, so you will very typically start from example records or rely on publishing software to generate them.

Most of this (including links to sample records) is explained on PURX' info page: http://dc.g-vo.org/purx/q/enroll/info.

Run a publishing registry

Even if your software has built-in support for OAI-PMH, the protocol behind information exchange within the Registry, running a publishing registry makes you part of a fairly complex, distributed bibliographic database; in particular, you'll be causing the VO's curators quite a bit of work if you later decide to not bother any more and just let the thing rot.

So, before you go down this road, ensure that the other two options won't work for you. Also, you should at least have had a brief look at the underlying VO standard, Registry Interfaces.

Having said that, OAI-PMH is not overly hard to implement, and starting from examples, writing VOResource records from whatever metadata you have isn't rocket science either. Also, some software (e.g., DaCHS) has built-in support for both VOResource and OAI-PMH), so once you're wrapped your head around what an authority is (see above), it's not so bad.

With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so.

If you want or have to write your own software to produce VOResource and/or speak OAI-PMH, here are some pointers:

<--  
-->

Revision 32017-11-23 - MarkusDemleitner

 
META TOPICPARENT name="IvoaResReg"
The Registry is the collection of metadata on the services in the Virtual Observatory. See IvoaResReg for more information about why you want your service in.

Registering a service requires two steps:

  1. create a resource record (this means producing an XML document valid according to a schema called VOResource; example)
  2. add the new resource record to the Registry (which in the end means that someone, possibly you, will have to offer your record through a protocol called OAI-PMH).
There are several different ways to do that; which one is the right for you depends, in particular, on how many services you want to register and how often their descriptions are expected to change (yes, you should keep your Registry entries up to date...). Below, we discuss three options:

  • Use a web browser (best if you have only very few and rarely changing records)
  • Use purx (best if you can machine-generate your resource records but only have a dozen or so resources)
  • Run a publishing registry (all other cases)
Changed:
<
<

Registration with a web browser

>
>

Choosing an authority identifier

 
Changed:
<
<
To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose whatever interface you consider nicer). This is sufficient if all you want is just register a handful of resources.
>
>
Unless you use purx, you will first have to choose an authority identifier.
 
Changed:
<
<
In either case, you will have to choose an authority identifier. That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.
>
>
That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.
  Consider, however, that the authority identifiers must be globally unique. The web interfaces won't let you create an authority that's already taken, but please don't be too generic (“astro” or “star” for instance, would probably not be appropriate authority identifiers).
Added:
>
>
Once you have chosen an authority id, make sure it is not taken already. The Registry contains a resource record for every authority taken, so this can be established by querying the Registry itself. You can use a WIRR query to do that (replace "org.gavo.dc" with what your new authority id in the form above).

With the browser interfaces discussed below, your authority id will be your login, and the services will claim the authority for you.

When, on the other hand, you run run your own publishing registry, the record for your authority should be the first thing you publish (that's “claiming the authority”). You can start from a (sample record to write the record.

Registration with a web browser

To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose whatever interface you consider nicer). This is sufficient if all you want is just register a handful of resources.

 A little walkthrough of the process was given at the first ASTERICS European Data Provider Forum.

Registration via purx

Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a “proxy” (to the rest of the Registry) service to that URL; the only such proxy service available right now is at http://dc.g-vo.org/purx/q/enroll/custom.

Writing valid (and search-friendly) VOResource documents isn't trivial, so you will very typically start from example records or rely on publishing software to generate them.

Most of this (including links to sample records) is explained on PURX' info page: http://dc.g-vo.org/purx/q/enroll/info.

Run a publishing registry

Even if your software has built-in support for OAI-PMH, the protocol behind information exchange within the Registry, running a publishing registry makes you part of a fairly complex, distributed bibliographic database; in particular, you'll be causing the VO's curators quite a bit of work if you later decide to not bother any more and just let the thing rot.

So, before you go down this road, ensure that the other two options won't work for you. Also, you should at least have had a brief look at the underlying VO standard, Registry Interfaces.

Having said that, OAI-PMH is not overly hard to implement, and starting from examples, writing VOResource records from whatever metadata you have isn't rocket science either. Also, some software (e.g., DaCHS) has built-in support for both VOResource and OAI-PMH), so once you're wrapped your head around what an authority is (see above), it's not so bad.

With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so.

If you want or have to write your own software to produce VOResource and/or speak OAI-PMH, here are some pointers:

Added:
>
>
 
<--  
-->

Revision 22017-11-15 - MarkusDemleitner

 
META TOPICPARENT name="IvoaResReg"
The Registry is the collection of metadata on the services in the Virtual Observatory. See IvoaResReg for more information about why you want your service in.

Registering a service requires two steps:

Changed:
<
<
[1] create a resource record (this means producing an XML document valid according to a schema called VOResource) [2] add the new resource record to the Registry (which in the end means that someone, possibly you, will have to offer your record through a protocol called OAI-PMH).
>
>
  1. create a resource record (this means producing an XML document valid according to a schema called VOResource; example)
  2. add the new resource record to the Registry (which in the end means that someone, possibly you, will have to offer your record through a protocol called OAI-PMH).
Added:
>
>
There are several different ways to do that; which one is the right for you depends, in particular, on how many services you want to register and how often their descriptions are expected to change (yes, you should keep your Registry entries up to date...). Below, we discuss three options:
 
Changed:
<
<
There are several different ways do do that; which one is the right for you depends, in particular, on how many services you want to register and how often their descriptions are expected to change (yes, you should keep your Registry entries up to date...). Below, we discuss three options:
>
>
  • Use a web browser (best if you have only very few and rarely changing records)
Deleted:
<
<
  • Use a web browser (best if you have only few rarely changing records)
 
  • Use purx (best if you can machine-generate your resource records but only have a dozen or so resources)
  • Run a publishing registry (all other cases)

Registration with a web browser

Changed:
<
<
To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose the one you like better). This is sufficient if all you want is just register a handful of resources.
>
>
To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose whatever interface you consider nicer). This is sufficient if all you want is just register a handful of resources.
  In either case, you will have to choose an authority identifier. That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.

Consider, however, that the authority identifiers must be globally unique. The web interfaces won't let you create an authority that's already taken, but please don't be too generic (“astro” or “star” for instance, would probably not be appropriate authority identifiers).

Added:
>
>
A little walkthrough of the process was given at the first ASTERICS European Data Provider Forum.
 

Registration via purx

Changed:
<
<
Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a (non-standard) service to that URL. Writing valid (and search-friendly) VOResource documents isn't trivial, so you will very typically start from example records or rely on publishing software to generate them.
>
>
Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a “proxy” (to the rest of the Registry) service to that URL; the only such proxy service available right now is at http://dc.g-vo.org/purx/q/enroll/custom.
 
Added:
>
>
Writing valid (and search-friendly) VOResource documents isn't trivial, so you will very typically start from example records or rely on publishing software to generate them.
 Most of this (including links to sample records) is explained on PURX' info page: http://dc.g-vo.org/purx/q/enroll/info.
Changed:
<
<

Run a pubishing registry

>
>

Run a publishing registry

 
Changed:
<
<
Even if your software has built-in support for OAI-PMH, the protocol behind information exchange within the Registry, running a publishing registry is a non-trivial effort; in particular, you'll be causing the VO's curators quite a bit of work if you later decide to not bother any more. So before you go down this road, ensure that the other two options won't work for you. Also, you should at least have had a brief look at the underlying VO standard, Registry Interfaces.
>
>
Even if your software has built-in support for OAI-PMH, the protocol behind information exchange within the Registry, running a publishing registry makes you part of a fairly complex, distributed bibliographic database; in particular, you'll be causing the VO's curators quite a bit of work if you later decide to not bother any more and just let the thing rot.
 
Changed:
<
<
Having said that, OAI-PMH is not overly hard to implement, and starting from examples, writing VOResource records from whatever metadata you have isn't rocket science either. Also, some software (e.g., DaCHS) has built-in support for both VOResource and OAI-PMH), so once you're wrapped your head around what an authority is (see above), it's not so bad.
>
>
So, before you go down this road, ensure that the other two options won't work for you. Also, you should at least have had a brief look at the underlying VO standard, Registry Interfaces.
 
Changed:
<
<
Anyway, once you have all that, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the RofR exactly there. Your records will be picked up by the Registry in a day or so.
>
>
Having said that, OAI-PMH is not overly hard to implement, and starting from examples, writing VOResource records from whatever metadata you have isn't rocket science either. Also, some software (e.g., DaCHS) has built-in support for both VOResource and OAI-PMH), so once you're wrapped your head around what an authority is (see above), it's not so bad.
Added:
>
>
With a set of records and some OAI-PMH service, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the Registry of Registries (or RofR for short), which the validator will let you do when you pass (but no earlier). After that, your records will be picked up by the searchable registries and hence the clients in a day or so.
  If you want or have to write your own software to produce VOResource and/or speak OAI-PMH, here are some pointers:

<--  
-->

Revision 12017-11-13 - MarkusDemleitner

 
META TOPICPARENT name="IvoaResReg"
The Registry is the collection of metadata on the services in the Virtual Observatory. See IvoaResReg for more information about why you want your service in.

Registering a service requires two steps:

[1] create a resource record (this means producing an XML document valid according to a schema called VOResource) [2] add the new resource record to the Registry (which in the end means that someone, possibly you, will have to offer your record through a protocol called OAI-PMH).

There are several different ways do do that; which one is the right for you depends, in particular, on how many services you want to register and how often their descriptions are expected to change (yes, you should keep your Registry entries up to date...). Below, we discuss three options:

  • Use a web browser (best if you have only few rarely changing records)
  • Use purx (best if you can machine-generate your resource records but only have a dozen or so resources)
  • Run a publishing registry (all other cases)

Registration with a web browser

To register your service, the easiest way is to use one of the web-based Registry publishing interfaces by either NAVO or ESAVO (it doesn't matter which, choose the one you like better). This is sufficient if all you want is just register a handful of resources.

In either case, you will have to choose an authority identifier. That's a short string that will be the “host part” of the identifiers of your services (the “ivoids”), for instance ivo://my-authority/foo/bar. Ideally, use an abbreviation of your institute or organisation, perhaps with your country added. If your DNS name is short enough, that's ok, too.

Consider, however, that the authority identifiers must be globally unique. The web interfaces won't let you create an authority that's already taken, but please don't be too generic (“astro” or “star” for instance, would probably not be appropriate authority identifiers).

Registration via purx

Here, you write a VOResource document yourself, then put the result on a normal web server, and then point a (non-standard) service to that URL. Writing valid (and search-friendly) VOResource documents isn't trivial, so you will very typically start from example records or rely on publishing software to generate them.

Most of this (including links to sample records) is explained on PURX' info page: http://dc.g-vo.org/purx/q/enroll/info.

Run a pubishing registry

Even if your software has built-in support for OAI-PMH, the protocol behind information exchange within the Registry, running a publishing registry is a non-trivial effort; in particular, you'll be causing the VO's curators quite a bit of work if you later decide to not bother any more. So before you go down this road, ensure that the other two options won't work for you. Also, you should at least have had a brief look at the underlying VO standard, Registry Interfaces.

Having said that, OAI-PMH is not overly hard to implement, and starting from examples, writing VOResource records from whatever metadata you have isn't rocket science either. Also, some software (e.g., DaCHS) has built-in support for both VOResource and OAI-PMH), so once you're wrapped your head around what an authority is (see above), it's not so bad.

Anyway, once you have all that, making sure your registry records are in the VO and updated whenever you update them then is as easy as going to the RofR validator (there's nothing wrong with also testing against the OAI Repository Explorer for non-VO interoperability) and then adding your OAI-PMH endpoint (a “publishing registry” in VO-speak) to the RofR exactly there. Your records will be picked up by the Registry in a day or so.

If you want or have to write your own software to produce VOResource and/or speak OAI-PMH, here are some pointers:

<--  
-->
 
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