Документ взят из кэша поисковой машины. Адрес
оригинального документа
: http://www.sao.ru/astrogrid-registry/regdocs/cookbook.jsp
Дата изменения: Unknown Дата индексирования: Sun Apr 10 05:04:10 2016 Кодировка: Поисковые слова: п п п п п п п п п п п |
Below are the most common questions and answers to the registry.
Publishing - is the smallest of all the types of registries and contains Resources managed by this Registry and only this registry. Other FULL Registries will harvest the publishing registries. It's primary purpose is to publish its contents when the Full Registries ask for the data. It does not have to have a Query interface but all Astrogrid Registries have both a Query and Harvest(Publishing) type interfaces. A publishing registry can also be part of a Full Registry but it is not recommended, we strongly encourage to not mix FULL and Publishing keep them separate. Full - this is a registry that contains all known resources and harvests all publishing registries known to the RofR (Registry of Registries) maintained by the IVOA. Note in the past we have found having a external eXist database to be more of an advantage for Full registries. Special - Rarely done but a registry that is setup to hold many resources but not ALL resources. Hence it usually harvests particular Registries of interest.
All XML/Resources in a registry have a unique identifier which is a URI. An identifier example is 'ivo://{authorityid}/{some unique string}' A registry may manage many authority id's and they will be owned by that particular registry. When creating this registry initially a main authority id was created, you may click on the menu to create more Authority id's. If you received an error about Authority ID not managed then you tried to enter XML with authority id you do not manage and you need to begin managing it. Note an authority id can be owned by only one registry, the IVOA Registry of Registries validator may detect that another registry already owns the authority id. In the past an authority id tends to go to a domain like syntax with the institute or project such as ucl.ac.uk or mssl.ucl.ac.uk
It can be nice but no it is not necessary and in fact it is much easier to set it up with a registry that is already functioning. You can click on the 'Manage New Authority' to add a new authority id then they will be allow to submit resources under that authority into the registry.
Most common install of the registry has an xml database named eXist installed inside the webapp and could potentially be dangerous when uninstalling or upgrading the registry may lose the data requiring a restore. See eXist_reference on how to move the internal database out.
There are two particular backups described below you may elect to do none, one, or both. Note the database does have a built in recovery system though
uncertain how much should be relied on this recovery.
A.) Binary - this method is the easiest because you are only copying one directory.
The database eXist will store all the xml in a binary format inside a directory called 'data'
which is currently still located in your webapp '$CATALINA_HOME/webapps//astrogrid-registry/WEB-INF/' you may wish to read
the above information about moving your database outside the webapp.
Since all the data is located in this directory you can backup and restore this directory if needed.
B.) XML - A script is used to make backups and restores of your database xml content. This has a small advantage if you are moving to an external database that
is a different version or if the above A. somehow still got corrupted. At the same location as your data directory you will see a backupandrestore.{sh/bat} at the top of this
file is directions and options on how to run the script.
Yes you can use an external eXist database. And does have an advantage because it can be on a different server, clustered, up to date version with bug fixes, along with other features. To do this go to eXist and learn how to install the database. The only property that must change in the registry is to change the xmldb.uri to 'xmldb:exist://{server}:{port}/exist/xmlrpc' If your using tomcat you can change the proerty here.
There are two places to find XML schemas that the registry can use: a.) http://software.astrogrid.org/schema/ --- IVOA official schemas and any extensions used at Astrogrid. b.) http://ivoa.net/xml/index.html --- IVOA official schemas.
This question assumes you have knowledge of schema and XML. There 4 steps: a.) Create your extension schema. b.) Place the schema on a public location so schemaLocation validation can occur. c.) Now create your XML instance document and try to upload it to the registry. YOU MUST ENSURE you define the schemaLocation attribute (and namespaces) on each Resource element (or one of it's sub elements). Hence do not define it at the top on 'VOResources' element those namespaces are not copied into the individual 'Resource' elements. d.) For the Search and keywordSearch queries you must edit the WEB-INF/classes/astrogrid.properties and add your declaration of namespace at the property 'reg.custom.declareNS.1.0'.