...
Note |
---|
The minimum computer specification for installing the DataSHIELD training environment is: - Ideally 12GB+ of RAM. Each VM is allocated 4GB RAM, and some needs to be spare for other applications.
- Reasonably powerful processor (for example: Intel i5 or i7).
- 16GB space on the hard disk.
- 7GB per VM + VirtualBox installation requirement (215 MB)
- Administrator rights on the computer. If you do not have administrator rights to install software on your computer contact your IT support to get the following installed on your machine.
|
Download and install VirtualBox
- Download VirtualBox from here.
- Double click on the downloaded executable file and click
Next
and Yes
to install the default settings.
Section |
---|
|
Download and install the Opal tutorial servers
Download the Opal servers (synthetic data are included)
Note |
---|
These Opal servers are 1-2 GB in size and may take some time to download. |
...
Note |
---|
You may see a network error warning, this is because the file is too big to preview in Google Drive. To continue, press the download button. Section |
---|
|
|
Import the Opal tutorial servers into VirtualBox
- To install each Opal tutorial server, select
File
from the top menu and then Import Appliance...
, browse to each downloaded tutorial file and install. - When you are finished, the VirtualBox main interface should show the two Opal servers.
Note |
---|
Importing the Opal servers should create the correct settings, however please check your settings match those below. |
Setting up the VirtualBox network adapter
- Select one of the Virtual Machines (VMs) and click on the orange cog settings on the top bar, right hand portion of the screen.
...
- Ensure Configure Adapter Manually is checked and
- IPv4 address: 192.168.56.1
- IPv4 Network Mask: 255.255.255.0
Starting the Opal Servers
Start the Opal Servers
To start an Opal server, open VirtualBox ,click on a server and click on the green arrow that says Start
(or just double click on the Opal server name).
...
Warning |
---|
Be aware, once the VM windows have started, clicking inside them can cause your mouse pointer to become captured. The default key to escape this is Right-Ctrl |
The Opal web interface
- This is a simple check to tell if the VMs have started.
- By going to the Opal web interface by opening a web browser and typing the IP address of each:
...
Code Block |
---|
title | Opal web interface login details |
---|
|
username: administrator
password: datashield_test& |
Install DataSHIELD client packages
Install R and Rstudio
Download and install R.
- Download and install Rstudio Desktop Open Source edition.
Install the DataSHIELD client package (in R or R Studio)
- Install DataSHIELD dependencies:
Code Block |
---|
|
install.packages('DSI')
install.packages('DSOpal')
install.packages('DSLite')
install.packages(c('fields', 'metafor', 'ggplot2', 'gridExtra', 'data.table'), dependencies=TRUE)
|
- Install the dsBaseClient R packages by typing into R:
Code Block |
---|
|
install.packages('dsBaseClient', repos=c(getOption('repos'), 'http://cran.obibadatashield.org'), typedependencies='source'TRUE) |
Tip |
---|
title | DataSHIELD client manuals |
---|
|
See: Current release |
Shutting down the Opal Servers
When you have finished your analysis, to shutdown the Opal server:
- click the cross at the top right of the window. This will give you a list of options for how to shutdown the machine:
- Select Send the shutdown signal.
Keeping up to date
Please see our keeping up to date wiki page in the user/analyst support section.
...