Skip to content

Latest commit

 

History

History
85 lines (53 loc) · 2.77 KB

README.md

File metadata and controls

85 lines (53 loc) · 2.77 KB
Raw

Nanopub Server

This is an implementation of a nanopublication server. Such servers form a server network, which can be used to publish nanopublications that have trusty URIs. Such a server only returns entire nanopubs. No queries supported; no triple store involved. The current implementation uses MongoDB to store the nanopubs.

Compilation and Deployment

Requirements:

  • Java 1.7 or higher
  • Access to a MongoDB instance
  • Disk space of up to around 10kB per nanopublication (5-6kB is average so far, but this value might change)

In addition, we assume here that Git and Maven are installed (tested with Maven version 3; version 2.0.9 might work too).

Now you can fetch the code for the nanopub server:

$ git clone https://github.com/tkuhn/nanopub-server.git

To configure the server, make a copy of the configuration file with the prefix local., which overrides the main configuration file:

$ cd nanopub-server/src/main/resources/ch/tkuhn/nanopub/server/
$ cp conf.properties local.conf.properties

Edit the file local.conf.properties to configure your instance of the server, and then compile it (run in the top nanopub-server directory):

$ mvn package

Then you can run the nanopub server using Maven's Jetty plugin:

$ mvn jetty:run

Now you should be able to locally access the server from your browser:

http://0.0.0.0:8080/nanopub-server/

Alternatively, you can give the file target/nanopub-server.war to a web application server such as Apache Tomcat. Then you can setup your web server to map a public URL to the nanopub server, for example:

http://example.org/np/ > http://0.0.0.0:8080/nanopub-server/

Add the public URL to the line public-url= of the configuration file and restart the server. Then, it will connect to the server network.

Usage

To retrieve a nanopub like

http://example.org/mynanopubs/RAPpJU5UOB4pavfWyk7FE3WQiam5yBpmIlviAQWtBSC4M

the artifact code (last 45 characters) has to be given to the nanopub server like this:

http://example.org/np/RAPpJU5UOB4pavfWyk7FE3WQiam5yBpmIlviAQWtBSC4M

File extensions can be used to retrieve the nanopub in different formats:

http://example.org/np/RAPpJU5UOB4pavfWyk7FE3WQiam5yBpmIlviAQWtBSC4M.trig
http://example.org/np/RAPpJU5UOB4pavfWyk7FE3WQiam5yBpmIlviAQWtBSC4M.nq
http://example.org/np/RAPpJU5UOB4pavfWyk7FE3WQiam5yBpmIlviAQWtBSC4M.xml

Depending on your browser settings, these URLs might open in an external editor or you might have to download them. In order to view them directly in the browser, .txt can be appended:

http://example.org/np/RAPpJU5UOB4pavfWyk7FE3WQiam5yBpmIlviAQWtBSC4M.nq.txt

License

This nanopub server is free software under the MIT License. See LICENSE.txt.