Infolis Web services
This software is licensed under the MIT license terms.
Try out the Infolis API UI.
The REST API is defined by the Infolis TSON.
This is a simplified API for simple clients, producing simple results using simple mechanics, simply encoded.
Find links between entities (publications, datasets, databases...).
Search from/to this identifiers
infolis-web should run on any BSD/Linux system supporting NodeJS and MongoDB. However we run our deployment on an Ubuntu 14.04 LTS Server system and assume deployment on a Debian/Ubuntu system in the following.
To install the requirements for a Ubuntu 14.04 LTS system, as root:
wget -qO- https://deb.nodesource.com/gpgkey/nodesource.gpg.key | apt-key add -
echo 'deb https://deb.nodesource.com/4.0 trusty main' > /etc/apt/sources.list.d/nodesource.list
echo 'deb-src https://deb.nodesource.com/4.0 trusty main' >> /etc/apt/sources.list.d/nodesource.list
apt-get update
apt-get install curl git nodejs raptor2-utils mongodb jekyll
git clone https://github.com/infolis/infolis-web
git clone https://github.com/infolis/infolis.github.io
To start the infolis-web service:
npm start
To start the infolis.github.io site locally
npm jekyll
To run and work infolis-web properly, you first have to fulfill the requirements by setting up a working environment on your system as described below:
Install Git, cURL, Nodesource, NodeJS, Raptor2 Utilities and MongoDB (in this order)
In order to receive your local copy of infolis web services later, you have to install git. Open your shell and type
sudo apt-get install git
cURL (CURL URL Request Library) is an open source library and command line tool for transferring data using various protocols. If cURL is not installed while working on InFoLiS web services, you will get a screen full of errors and an empty ~/.shcolor.sh file.
Open your shell and type
sudo apt-get install curl
Install the Nodesource repository as described here:
Open your shell and type
curl -s https://deb.nodesource.com/gpgkey/nodesource.gpg.key | apt-key add -
echo 'deb https://deb.nodesource.com/{VERSION} {DISTRO} main' > /etc/apt/sources.list.d/nodesource.list
echo 'deb-src https://deb.nodesource.com/{VERSION} {DISTRO} main' >> /etc/apt/sources.list.d/nodesource.list
Replace "VERSION" with the version of NodeJS you want to install (e.g. 4.0
) and "DISTRO" with the name of
your distribution (e.g. trusty
).
We recommend to use a NodeJS version from after the io.js-reunification, i.e. >= 4.0.
To find your distro name, check the /etc/*-release
file, e.g.
cat /etc/*-release
> [...]
> DISTRIB_CODENAME=vivid
> [...]
After receiving Nodesource, type
sudo apt-get update
Node.js is a JaVaScript runtime designed to build scalable network applications.
Open your shell and type
sudo apt-get install nodejs
Be sure that you have NodeJS Version 4.0.0 or later. You can look up your version by typing
nodejs --version
Raptor 2 RDF parser and serializer utilities provides the rapper tool for validation, parsing and serializing RDF syntaxes.
Open your shell and type
sudo apt-get install raptor2-utils
MongoDB is an open source database.
Open your shell and type
sudo-apt get install mongodb
npm is a package manager for JavaScript. You will need it to run the services.
Open your shell and type
npm install --verbose
Login to your GitHub Account and fork the following repositories:
Make new directories for both repositories and clone them to receive your local copy.
git clone [email protected]:yourgithub/infolis.github.io
git clone [email protected]:yourgithub/infolis-web
Host the Services on your local server. You can serve infolis.github.io
via Jekyll and infolis-web
via npm.
Infolis.github.io
contains the landing page for the project and additional information.
cd to your infolis.github.io
directory and type
jekyll serve
Open your browser. infolis.github.io
will be available under localhost:4000
.
Infolis-web contains all the web services of InFoLiS.
cd to your infolis-web
directory and type
npm run start
to host the web services under localhost:3000/
.
The following services are available:
- API Explorer:
localhost:3000/api
- Raptor Graph Serialisation (Infolink Schema):
localhost:3000/schema
- Linked Data Fragments:
localhost:3000/api/ldf
- Monitor:
http://localhost:3000/api/monitor
- Datastore stats:
localhost:3000/api/stats