This explains how to set-up a virtual machine (VM) in VirtualBox, to act as either a 'data computer' (server) or 'analysis computer' (client) for DataSHIELD.
Note: you don't have to do the setup manually. |
The OBiBa github page provides scripts to automate this:
Opal
and DataSHIELD
.Start the VM. Edit /etc/network/interfaces:
$ sudo vi /etc/networking/interfaces |
For the primary interface it will list the lines:
auto eth0 iface eth0 inet dhcp |
This is likely to be the NAT adapter - ensure that eth0 is the correct interface, by checking with the ifconfig
or ip addr
commands.
Note: You have make sure you get the interfaces the right way round. In this example, eth0 is the NAT adapter; eth1 is the host-only adapter. This depends on the order you set up the adapters for the VM, or whether you cloned the VM from elsewhere and reinitialised the MAC address. |
For the host-only interface (likely eth1), you are going to change 'dhcp' to 'static' and add the static configuration. Assuming the host-only adapter has the address 192.168.56.1 (default), then edit the interface (eth1) as follows:
auto eth1 iface eth1 inet static address 192.168.56.100 # ^^^ IP Address for the VM netmask 255.255.255.0 network 192.168.56.0 broadcast 192.168.56.255 |
To test your changes, restart networking in the virtual machine:
$ sudo service networking restart |
And view the interfaces:
$ ip addr |
This should list the IP you assigned in /etc/network/interfaces.
With the host only network set up you can ssh from the host machine into the VMs (or, of course, from one VM to another):
$ ssh user@192.168.56.100 |
If this fails, check the host is connected to the host-only interface.
You can download a script that will perform a basic install of opal and its dependencies.
Data can be added to opal using the web interface, accessible at:
192.168.56.100:8080 or :8443 |
from a browser on the host.
By default:
username: administrator password: password |
Instructions can be found in the opal documentation.