Virtual Machine (VM) Image Guide

VM image

We created a VM image for Oracles VirtualBox environments using VirtualBox version 4.2.12 build 84980.
The image is for desktop PC or laptops and runs a Debian OS containing all dependencies required by Triplex-Inspector. You can download the VM image from here.

VM image setup

1.) Install VirtualBox
Download and install the
VirtualBox environment for your plattform.

2.) Download the Tripex VM image
Download from here

3.) Untar the Triplex VM image
Unpackage the tarball using either an archiver (e.g. for Windows) or the command line via a terminal:

>tar xf TriplexatorVM.tar.gz

This should yield a file called Triplex.ova.

4.) Import the VirtualBox image
Start the VirtualBox and go to File > Import Appliance.
Click Open appliance and select the Triplex.avo file using the File Browser provided.
Open Virtual Machine Image

Click continue.
If you like you can change the name for the VM (e.g. Triplex-Inspector and disable the checkbox next to DVD. Configure Virtual Machine Image

Click Import and wait for the process to finish.
After that you should have the image installed and see the following screen: Virtual Machine Image Installed

Depending on you system, you may want to adjust various parameters, such as memory (RAM) etc, via settings.

VM bootup

To boot the VM click on Start. During the boot process you may encounter a popup about mouse pointer integration. Tick the box, if you like, and click ok.

Use the following login details:
Username: triplex
Password: triplex

For root access use:
Username: root
Password: triplex

This gets you access to the console: Virtual Machine Console Access

To get to Triplexator and Triplex-Inspector change the directory:
>cd /opt/triplexator

Invoke the smoketest to check if Triplexator works as advertised:
>./demos/smoketest_triplexator.sh ./bin/triplexator
Triplexator smoketest

You can also test Triplex-Inspector using the following commands:
>cd /opt/triplexator/triplex_inspector/test
>./run_test.sh

This test will take a minute to run. You may see a warning about the output folder already existing. This is not crucial as the test is instructed to overwrite the output location. If everything worked out the results will be in the same directory under results/ Triplex-Inspector test

Leave the terminal session by typing:
exit

You can then power off the VM by either closing the window or right clicking on the VM and clicking Close > Power off.

Link your data

To work with your data, we create a shared folder. This way there is no need to copy the data across.

To configure a shared folder the VM must be in powered off. Click on Settings. Virtual Machine Image Powered Off Mode

Then select the Shared Folders from the top row.
Virtual Machine Image Shared Folder - Step 1

Click the "Folder Plus" Button and select the Folder you like to access from within the VM. Tick the corresponding box if you like this folder to be mounted automatically.
Virtual Machine Image Shared Folder - Step 2

Virtual Machine Image Shared Folder - Step 3

You can add more folders if you like. Once all Folders have been specified, click OK.
Start the VM by clicking the green Start button and wait for the VM to boot. Log on using the triplex credentials specified before.

Make a directory that serves as the mount point, e.g.:
>mkdir ~/data

You then need to mount the shared folder:
>sudo mount -t vboxsf -o uid=1000,gid=1000 shared_folder_name /home/triplex/data

Here, shared_folder_name is the name of the shared folder. In the example, it would be TFO_design. Voila, you can now access your data at /home/triplex/data.

Important note: When running Triplexator or Triplex-Inspector point to the data in your mounted folder and also specify an output directory at a shared folder location as the space available within the VM is very limited.

Update the Triplexator suite

You should be able to update the Triplexator suite within the VM image using git, e.g.:
>cd /opt/triplexator
>git pull