https://github.com/rdfio/rdfio-vagrantbox
An automated Virtual Machine setup (Vagrant box) for trying out the RDFIO extension for Semantic MediaWiki.
https://github.com/rdfio/rdfio-vagrantbox
Last synced: 28 days ago
JSON representation
An automated Virtual Machine setup (Vagrant box) for trying out the RDFIO extension for Semantic MediaWiki.
- Host: GitHub
- URL: https://github.com/rdfio/rdfio-vagrantbox
- Owner: rdfio
- License: mit
- Created: 2015-09-17T17:49:46.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-10-04T08:59:16.000Z (over 7 years ago)
- Last Synced: 2025-02-02T12:35:44.568Z (3 months ago)
- Language: Shell
- Homepage:
- Size: 70.3 KB
- Stars: 1
- Watchers: 3
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# RDFIO Virtual Machine Setup or "Vagrant box"
This is an automatic setup script for setting up a Virtual Machine with [MediaWiki](https://www.mediawiki.org) (the software behind Wikipedia), [Semantic MediaWiki](https://www.semantic-mediawiki.org) (which adds structured data editing features to MediaWiki) and the [RDFIO](https://github.com/rdfio/RDFIO) extension, which adds data import, export and querying support to Semantic MediaWiki.
It is very simple to use: Clone this git repository into a folder on you computer, install Vagrant, Ansible and Virtualbox (which are super easy to install on most systems), and then run `vagrant up` in the folder, and just wait for the script to do its job. See the [installation section](#Installation) for more details.
In technical terms, this setup uses [Vagrant](https://www.vagrantup.com/) as a wrapper, to allow starting the script with one simple command (`vagrant up`) and [Ansible](https://www.ansible.com/) for doing the installation and configurations (often called "provisioning") in the background.
The fact that Ansible is used for provisioning, means that the installation
instructions are easy to understand and change, and that they can be equally
well installed elsewhere too, like in the cloud, or a local computer.
# Updates
**Sep 4, 2017:** Our paper on RDFIO was just published:
Lampa S, Willighagen E, Kohonen P, King A, Vrandečić D, Grafström R, Spjuth O
[RDFIO: extending Semantic MediaWiki for interoperable biomedical data management](https://jbiomedsem.biomedcentral.com/articles/10.1186/s13326-017-0136-y)
*Journal of Biomedical Semantics*. **8**:35 (2017). DOI: [10.1186/s13326-017-0136-y](https://dx.doi.org/10.1186/s13326-017-0136-y).
# Installation
## Prerequisites
The vagrant box requires the following softwares in order to set it up:
- [Virtualbox](https://www.virtualbox.org/)
- [Vagrant](https://www.vagrantup.com/)
- [Ansible](https://www.ansible.com/)
- An SSH Client (Already included in Linux and OS/X)
For Ubuntu 16.04, we provide brief installation instructions for them below:
### Virtualbox
Install on Ubuntu 16.04 with:
```bash
sudo apt-get install virtualbox
```
### Vagrant
Install on Ubuntu 16.04 by [downloading the debian installer](https://www.vagrantup.com/downloads.html) and installing it:
```bash
wget https://releases.hashicorp.com/vagrant/1.8.1/vagrant_1.8.1_x86_64.deb
sudo dpkg -i vagrant_1.8.1_x86_64.deb
```
### Ansible
**N.B:** Probably needs Ansible 2.x or higher! (Works well with 2.0.2, but **not** 1.7.2)
Install on Ubuntu 16.04 with:
```bash
sudo apt-get install ansible
```
## Bring up the Vagrant box
Clone this repo:
```bash
git clone https://github.com/rdfio/rdfio-vagrantbox
```
Enter the cloned folder:
```bash
cd rdfio-vagrantbox
```
... and let vagrant take care of the rest:
```bash
vagrant up
```
Surf in to your new MediaWiki installation on:
* [localhost:8080/w](http://localhost:8080/w)
Log in with "Admin" and "changethis".
Done!
To see the MediaWiki installation via the commandline, you can SSH in to your machine and enter the wiki installation folder like so:
```bash
vagrant ssh
cd /var/www/html/w
```
## Known issues
After bringing up the vagrant box, you might see an error like this:
```bash
==> virtualbox: mesg: ttyname failed: Inappropriate ioctl for device
```
This is a minor glitch with vagrant, and nothing to worry about.