Version 13 (modified by 11 years ago) (diff) | ,
---|
Responsible for this page: André Moreira?. Content checked: see last modified date.
Purpose
The purpose of this page is to collect relevant information about SCHEMAcat.
Project: SCHEMAcat
The schema registry, aka SCHEMAcat, is a store for records with information about resource schemas.
Contents
People
Status
Alpha available: http://lux13.mpi.nl/schemacat
Functionality
- Shibboleth based access and user management (for upload and maintenance)
- Upload a schema (in any textual form)
- Assign a PID (EPIC API)
- Enter some metadata (CMDI schema)
- Maintain the metadata
- Download a schema
- Browse the schema registry
- Version management
- (Interface with RELcat and CMDI Registry)
Service dependencies
SCHEMAcat is envisioned to interface with other webservices and CLARIN registries trough their REST API:
- MPI handle server - PID management
- Data Category Registry (ISOcat)
- Relation registry (RELcat)
- CMDI component registry and editor
Getting code
- You can browse the code here
- Check out SCHEMAcat code from:
https://svn.clarin.eu/cats/SCHEMAcat
- You will also need our 'SLOOT' (TOOLS) module for NetKernel 5 from :
https://svn.clarin.eu/cats/shared/urn.org.isocat.sloot/trunk
- You will also need our 'SLOOT' (TOOLS) module for NetKernel 5 from :
System Requirements
- Java 5
- 1060 NetKernel 5.1.1 Standard Edition Developer Kit and extra NetKernel modules:
- NetKernel 5 'html5-frameworks' module.
- NetKernel 5 'xml-saxon' module.
- NetKernel 5 'lang-javascript' module.
- BaseX 7.6
Building and Deploying
NetKernel
- Download the 1060 NetKernel 5.1.1 Standard Edition Developer Kit distribution JAR file from the NetKernel Portal.
- Boot NetKernel from the JAR file.
#java -jar 1060-NetKernel-SE-5.1.1.jar
- Point your browser to http://localhost:1060 to access the NetKernel management panels.
- Select the 'Install' tab, the 'Install NetKernel' service and then follow the directions.
Initially NetKernel boots directly from its distribution JAR and can be explored immediately. Use the installation service to create a custom installation of NetKernel on your disk.
- With NetKernel installed on your computer, use the Apposite repository to obtain updates to the installed modules, this will ensure you are running with the latest updates and capabilities. To access 'Apposite', select the 'Apposite' tab and then the 'Apposite' client service.
- Download and install the missing modules used by SCHEMAcat which are not installed by default:
- html5-frameworks
- saxon-xml
- lang-javascript
SLOOT NetKernel module
- Checkout the SLOOT NetKernel module, which is an in-house developed module with generic NetKernel tools, from cats/shared into an own folder
- Add the following (adapt the path to point to your SLOOT source directory) to the end (before
</modules>
) ofpath-to-1060-NKSEDK-5.1.1/etc/modules.xml
to enable this module<module>/path-to-SLOOT/src/urn.org.isocat.sloot/</module>
SCHEMAcat NetKernel modules
- Checkout the 4 SCHEMAcat NetKernel modules, from https://svn.clarin.eu/cats/SCHEMAcat/trunk into own folders.
- urn.org.isocat.schemacat.interface.rest
- urn.org.isocat.schemacat.site
- urn.org.basex.rest
- urn.org.isocat.schemacat.access.data
- Add the following (adapt the path to point to your SCHEMAcat source directory) to the end (before
</modules>
) ofpath-to-1060-NKSEDK-5.1.1/etc/modules.xml
to enable this module<module>/path-to-SCHEMAcat/src/urn.org.isocat.schemacat.interface.rest/</module> <module>/path-to-SCHEMAcat/src/urn.org.isocat.schemacat.site/</module> <module>/path-to-SCHEMAcat/src/urn.org.basex.rest/</module> <module>/path-to-SCHEMAcat/src/urn.org.isocat.schemacat.access.data/</module>
SCHEMAcat BaseX database
SCHEMAcat data is expected to be loaded into a BaseX collection named SCHEMAcat by default. Menzo has created a little script to help with that: https://svn.clarin.eu/cats/SCHEMAcat/trunk/various/scripts/create-BaseX-database.bxs
- Checkout the 'data' folder containing the initial SCHEMAcat data, from https://svn.clarin.eu/cats/SCHEMAcat/trunk
- Edit the script file 'create-BaseX-database.bxs' and adapt the path inside pointing it to your checked-out 'data' folder.
- Run the script with basexclient -c.
- Configure the file /path-to-SCHEMAcat/urn.org.isocat.schemacat.access.data/etc/BaseXConfig.xml to use your local BaseX configuration. i.e.
- REST interface host.
- REST interface port.
- REST interface path.
- Collection name ('SCHEMAcat' if the create-BaseX-database.bxs script was used to bootstrap the database).
- BaseX username.
- BaseX password.
SCHEMAcat BaseX database
With both NetKernel and BaseX running in your machine, access SCHEMAcat by surfing to:
http://localhost:8080/schemacat/site/index.html
Tickets
List of all open tickets for this component: