Version 11 (modified by 12 years ago) (diff) | ,
---|
Responsible for this page: Menzo Windhouwer?. Last content check: 27-08-2012
Purpose
The purpose of this page is to collect relevant information about ISOcat.
Project: ISOcat
ISOcat is an implementation of ISO 12620:2009, which describes the data model and procedures around a Data Category Registry (DCR).
Contents
People
Getting code
- You can browse the code here
- Check out from:
http://svn.clarin.eu/cats/ISOcat
System Requirements
- Java 6
- 1060 NetKernel 3.3.1 Standard Edition Development Kit (with some additional patches included in our codebase)
- PostgreSQL 8.x (an external instance uses 9.x)
- General Interface 3.9.1
- Tango icon library (to be phased out, but still some leftovers)
- famfamfam silk icon library and silk companion
- the ISOcat forum is based on phpBB (with some additional patches included in our codebase)
Dependencies
There are several other CLARIN projects that make use of data categories and use the ISOcat REST API:
- CMDI component registry and editor
- Arbil (for CMDI)
There are also companion registries under development:
- RELcat, a Relation Registry
- SCHEMAcat, a Schema Registry
Building and Deploying
- download and install 1060 NetKernel 3.3.1 Standard Edition Development Kit
- start NetKernel using the appropiate startup script in
1060-NKSEDK-3.3.1/bin
- goto http://localhost:1060
- goto the Module Management Wizard in the control panel and update all existing modules
- at time of writing this will update the HTTP Client Services, the HTTP Transport and XQuery
- shutdown NetKernel (Kernel Shutdown in the control panel)
- checkout our precompiled NetKernel patches from cats/patches/NetKernel/trunk/dist
- and copy these files in the equivalent places in your NetKernel? installation directory
- remove all jars from
1060-NKSEDK-3.3.1/lib/expanded
, so the libraries our patched modules use will be unpacked with a next restart - checkout some 3rd party NetKernel modules from cats/patches/NetKernel/trunk/contrib
- copy these jars into
1060-NKSEDK-3.3.1/modules
- add the following to the end (before
</modules>
)1060-NKSEDK-3.3.1/etc/deployedModules.xml
to enable these modules<module>modules/mod-e4x-1.0.0.jar</module> <module>modules/db-metadata.jar</module> <module>modules/mod-stink-0.1.0.jar</module> <module>modules/test-stink-0.1.0.jar</module>
- checkout the ISOcat NetKernel modules from cats/ISOcat/trunk in your ISOcat source code folder
- the modules in the
develop
are NetKernel modules to serve static files that in a production environment will be served by the HTTP server, e.g., Apache - some of these static files need to be downloaded and placed in the right directory
- download the General Interface 3.9.1 Debug edition (in a production environment use the Standard edition) and place the content of the archive into the
develop/mod-gi/gi/3.9.1/
directory - download the Tango icon library
tango-icon-theme
and place the content of the archive into thedevelop/mod-Tango/Tango/
directory (in a production environment ISOcat only needs the16x16
subdirectory) - download the famfamfam silk icon library and place the content of the archive into the
develop/mod-famfamfam/famfamfam/silk
directory - download the silk companion and place the content of the archive into the
develop/mod-famfamfam/famfamfam/silk-companion
directory (there are several other silk companion icon sets, which might be interesting for new developments)
- download the General Interface 3.9.1 Debug edition (in a production environment use the Standard edition) and place the content of the archive into the
- add the following (adapt the path to point to your ISOcat source directory) to the end (before
</modules>
)1060-NKSEDK-3.3.1/etc/deployedModules.xml
to enable these modules<module>/ISOcat/src/develop/mod-gi</module> <module>/ISOcat/src/develop/mod-Tango</module> <module>/ISOcat/src/develop/mod-famfamfam</module>
- tell the NetKernel? HTTP frontend fulcrum to resolve request for the files of these modules by adding the following below the Add your modules below here... comment in
1060-NKSEDK-3.3.1/modules/mod-fulcrum-frontend/module.xml
<import> <uri>urn:gi</uri> </import> <import> <uri>urn:tango</uri> </import> <import> <uri>urn:famfamfam</uri> </import>
Interfaces
There is a public readonly REST API and the General Interface web UI.
Manual
See the manual page at isocat.org
Design
Tickets
There is a public bug and issue tracker at SourceForge.
Servers
The ISOcat production server is www.isocat.org.
The ISOcat test server is lux13, which also hosts alpha versions of RELcat and SCHEMAcat.
Status, Planning and Roadmap
Status: active
Planning and roadmap: