Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

Configure the network

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

Anchor
startopal
startopal

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

...

Code Block
titleOpal 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:

...

Tip
titleDataSHIELD 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.

...