SEEK Virtual Machine ( version 1.2.2)

Getting the virtual machine image

VirtualBox is required to run the virtual machine. To build this image, we use Virtual Box version 5.0.36 on the linux based Ubuntu Server 16.04.2(LTS).

You can download the image using the following link: SEEK Virtual Machine 1.2.2

Using the virtual machine

The virtual machine can be imported into VirtualBox using File/Import Appliance. Browse to the downloaded file and follow the instructions. Once the machine has been started there will be some startup messages, and finally you should be presented with a login prompt.

Important settings

User credentials

These are the credentials needed to login and use the virtual machine. They are not the credentials for logging into SEEK.

Username: seek
Password: seek

You should change the default password, and even better create a new user, as soon as you can.

This user has full sudo access.

Networking information

By default the virtual machine is configured to use NAT (Network Address Translation) and Port forwarding. This is neccesary where the machine is running and is unable to obtain its own IP Address on you network without registering its MAC address. This is common in many institutions.

If in your institution you are able to obtain an IP Address, or can register the virtual machines network interface MAC address you can switch to a Bridged Network (in the Network settings for the virtual machine) and ignore the next set of instructions.

The ports are forwarded for SSH and HTTP between 2222,3333 and 22,80 respectively.

So to ssh from the host into the machine you should use:

ssh -l seek -p 2222 localhost
(use 127.0.0.1 if localhost does not work)

and to access SEEK through a browser on the host machine:

http://localhost:3333

Should you require access to SEEK other than locally, you will need to configure additional port forwarding on the host machine.

Paths

/srv/rails/seek - the SEEK installation location

/srv/rails/seek/filestore - the filestore location

/var/backups/rdiff-backup - a 2AM nightly cronjob runs as root and backs up the database and any asset files to this location using the rdiff-backup tool. You may need to set the time on the virtual machine for this to run at the correct time for you.

Creating the Administrator account

Once you access SEEK through your browser, you first need to create an initial account that will also act as the Administrator account. As the first user, you are by default linked to Default Project and Default Institution.

Using the admin pages you can configure the behaviour of SEEK, including some rebranding and enabling and disabling some services, in particular PUBMED and DOI support.
You should read our Administration Guide for details of some basic tasks and settings.

Older versions

SEEK v.1.1.2
SEEK v.1.1.1
SEEK v.0.23.0
SEEK v.0.19.1
SEEK v.0.16.3