The minimum computer specification for installing the DataSHIELD training environment is:
|
Next
and
Yes
to install the default settings.These Opal servers are 1-2 Gb in size and may take some time to download. |
download
button and click
download anyway
.You may see a network error warning, this is because the file is too big to preview in Google Drive. To continue, press the |
File
from the top menu and then
Import Appliance...
, browse to each training Opal server file and install.Importing the Opal servers should create the correct settings, however please check your settings match those below. |
File
and select
Preferences...
, this opens up a VirtualBox settings window.
Host-only Networks
click on
Network
and then click on the screw driver icon on the right which says
Edit host-only network (Space)
when you hover on it.
Adapter
tab set:
DHCP Server
tab make sure that
Enable server
is unchecked. Select
OK
to save the settings.Using the current version of Virtual Box and the current version of Opal, we have found that on some platforms if you close down and power off the VM server in the usual way (by right clicking on the server and following the instructions, or by using the Machine menu) Opal halts incorrectly and prevents the VM from booting up correctly the next time. It is essential to take a snapshot of the pristine server when it is first imported (before you first start it up). Then you can always use that snapshot to start the VM correctly (with Opal working). |
Snapshots
You can customise the names of snapshots and take as many as you like to save different states of the Opal server. For example, you could take Snapshot 1 straight after importing the Opal server, and then later Snapshot 2 after uploading some of your own simulated data. |
To start an Opal server just open VirtualBox click on a server and click on the green arrow that says
Start
(or just double click on the Opal server name).
Depending on how powerful your computer is, the Opal servers may take a few minutes to boot and for Opal to start.
enter
on your keyboard.For example: to access the web interface for dstesting-100 and dstesting-101, go to:
http://192.168.56.100:8080
http://192.168.56.101:8080
Because these VMs are internal to your computer, there is no need for encryption so port :8080 is safe, in addition you should be able to login to the local servers even if you have no internet access.
Try using port 8443 > https:/192.168.56.100:8443 and https:/192.168.56.101:8443 .You will get a warning when connecting to 8443 because the SSL certificate is self-signed. |
Opal is running and ready if the opal login screens is available. You do not need to login; just check that a login webpage is available.
If at this point your Opal server(s) are not working, right click on an Opal server name and select |
username: administrator password: datashield_test& |
install.packages('RCurl', dependencies = TRUE) install.packages('rjson', dependencies = TRUE) install.packages('fields', dependencies = TRUE) |
opal
and
datashieldclient
R packages by typing into R:install.packages('opal', repos='http://cran.obiba.org', type='source') install.packages('datashieldclient', repos='http://cran.obiba.org', type='source') |
If you get the message
|
See: Current release |
When you have finished your analysis, to shutdown the Opal server:
Power off the machine
and check the box marked
Restore current snapshot
.This will revert the Opal server to the state it was in when the snapshot was taken.
Any changes you have made since this point, such as uploading data or updating server-side packages will be lost. |
To shutdown the Opal server without losing any changes you have made to uploaded data or server-side DataSHIELD packages:
Username: user password: password |
sudo poweroff |
Further instructions are available for the advanced uses of the DataSHIELD training environment: |
You are now fully set up. To start using the DataSHIELD training environment sit our v4 Tutorial for DataSHIELD users. The tutorial teaches you the basics of DataSHIELD including how to:
|