e

• Update or install packages on the training Opal servers

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.

Download and install the training Opal servers

Download the Opal servers (synthetic data are included)

• Right click and open each of the Opal training servers in a new window.

• Select the download button and click download anyway .

Import the training Opal servers into VirtualBox

• To install each training Opal servers select File from the top menu and then Import Appliance... , browse to each training Opal server file and install.
• When you are finished, the VirtualBox main interface should show the two Opal servers (Note: The version 'v2' may be different).

Configure the network

Setting up the VirtualBox network adapter

• On the VirtualBox top menu go to the tab File and select Preferences... , this opens up a VirtualBox settings window.
• Inside that window and under the tab 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.

• Under the Adapter tab set:
  IPv4 address: 192.168.56.1
  IPv4 Network Mask: 255.255.255.0

• Under DHCP Server tab make sure that Enable server is unchecked. Select OK to save the settings.

Starting the Opal Servers

Snapshot the Opal Servers 

• Before starting the Opal servers it is very useful to take a snapshot of each Opal server. This enables you to roll-back the Opal servers to a pristine state, without needing to delete them and repeat the process above to re-import them. To take a snapshot:
• first open VirtualBox and click on a server. 
• Click the button in the top right that says Snapshots

• Take a snapshot of the server by clicking the leftmost camera icon:

• Repeat for each Opal server.

Start the Opal Servers

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.

• If you are presented with more than one Operating System in the black 'Oracle VM VirtualBox' window select the first option by pressing enter on your keyboard.

The Opal web interface

• Check whether Opal has been started by going to the Opal web interface by opening a web browser and typing the ip address of the VM, followed by the port number.

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.

• 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. 

•  Should you require logging into the Opal web interface e.g. to upload your own data etc:

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

install.packages('RCurl', dependencies = TRUE)
install.packages('rjson', dependencies = TRUE)
install.packages('fields', dependencies = TRUE)

• Install the  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')

install.packages('opal', repos='http://cran.obiba.org', type='source')
install.packages('dsBaseClient', repos='http://cran.obiba.org', type='source')
install.packages('dsModellingClient', repos='http://cran.obiba.org', type='source')
install.packages('dsGraphicsClient', repos='http://cran.obiba.org', type='source')
install.packages('dsStatsClient', repos='http://cran.obiba.org', type='source')

Update the DataSHIELD server side packages

• Follow the instructions - Update the training Opal environment
• Once you have updated each Opal server, follow the instructions to shut down each server whist retaining the changes - Shutdown if changes are made to Opal servers
•  Take another snapshot of each VM. 

Shutting down the Opal Servers

If no changes to Opal servers (e.g. for general users)

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

If changes are made to Opal servers (e.g. for developers) 

To shutdown the Opal server without losing any changes you have made to uploaded data or server-side DataSHIELD packages:

• from the Opal training server command line log into the Opal using:

Username: user
password: password

• type the shutdown signal into the command line:

sudo poweroff

• Once the Opal training server has shutdown take a snapshot in order to preserve the changes made to the VM

• Repeat for each Opal server