Setting Up The Dutch Digital Heritage Network Virtual Research Environment (ViPER) Guide

This guide is intended to help you install VirtualBox then download and import the ViPER machine.

About ViPER

ViPER is an easy-to-install virtual machine running popular open source preservation tools with graphical user interfaces. It was created by the Open Preservation Foundation (OPF) and funded by the Dutch Digital Heritage Network (DDHN). ViPER is maintained by the National Archives of the Netherlands and the OPF. Oracle Virtualbox that provides the basis for cross platform virtualisation and makes use of Gnome that provides the default desktop environment.

Pre reqs

In order to use the ViPER you will need to:

Creating the VM environment

Checking your desktop

If you have a system administrator, ask them to check the BIOS settings on your desktop have been enabled for virtualisation. If not then this is usually done at startup, the process for doing this varies so refer to the manufacturer’s instructions.

Downloading Oracle Virtualbox

ViPER has been built and tested using Oracle Virtualbox. Virtualbox can be installed across several O/S including Windows (NT 4.0, 2000, XP, Server 2003, Vista, Windows 7, Windows 8, Windows 10), DOS/Windows 3.x, Linux (2.4, 2.6, 3.x and 4.x), Solaris and OpenSolaris, OS/2, and OpenBSD. Note ViPER has been baselined to work with Oracle Virtualbox v6.1.44.

The Virtualbox download comprises two parts, Virtualbox and the Virtualbox extension, both must be downloaded. Both downloads are accessed via the following link Oracle Virtualbox download. The link will take you to the Oracle Virtualbox download page. From here select the relevant platform package, the options are:

Windows; OS X; Linux; Solaris

Oracle Virtualbox Setup and Installation

When the Oracle Virtualbox download has completed, immediately repeat the exercise by downloading the Virtualbox extension pack .
When both downloads are completed install by selecting each exe file. As you download each file a series of install dialogue boxes will be displayed, unless you wish to change any of the specific items they can all be Ok’d. Note when installing Virtualbox a warning message may be displayed stating that your network interfaces may be reset and become temporarily unavailable during the install process.

Downloading ViPER

ViPER is downloaded as a single machine image as a prebuilt OVA file. The most current version can be downloaded via the following link: https://viper.openpreservation.org/viper-latest.ova. Note this is a file of several GB and will take several minutes to download. When the download has completed select the .exe file to complete the installation process. This will open a dialogue box that will give you the option to import the virtual appliance (ViPER) - proceed by selecting ‘import’.