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.
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:
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.
Click continue.
If you like you can change the name for the VM (e.g. Triplex-Inspector and disable the checkbox next to DVD.
Click Import and wait for the process to finish.
After that you should have the image installed and see the following screen:
Depending on you system, you may want to adjust various parameters, such as memory (RAM) etc, via settings.
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.
Click continue.
If you like you can change the name for the VM (e.g. Triplex-Inspector and disable the checkbox next to DVD.
Click Import and wait for the process to finish.
After that you should have the image installed and see the following screen:
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:
Password:
For root access use:
Username:
Password:
This gets you access to the console:
To get to Triplexator and Triplex-Inspector change the directory:
Invoke the smoketest to check if Triplexator works as advertised:
You can also test Triplex-Inspector using the following commands:
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/
Leave the terminal session by typing:
You can then power off the VM by either closing the window or right clicking on the VM and clicking Close > Power off.
Use the following login details:
Username:
triplexPassword:
triplexFor root access use:
Username:
rootPassword:
triplexThis gets you access to the console:
To get to Triplexator and Triplex-Inspector change the directory:
>cd /opt/triplexatorInvoke the smoketest to check if Triplexator works as advertised:
>./demos/smoketest_triplexator.sh ./bin/triplexatorYou can also test Triplex-Inspector using the following commands:
>cd /opt/triplexator/triplex_inspector/test>./run_test.shThis 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/
Leave the terminal session by typing:
exitYou 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.
Then select the Shared Folders from the top row.
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.
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.:
You then need to mount the shared folder:
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
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.
To configure a shared folder the VM must be in powered off. Click on Settings.
Then select the Shared Folders from the top row.
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.
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 ~/dataYou then need to mount the shared folder:
>sudo mount -t vboxsf -o uid=1000,gid=1000 shared_folder_name /home/triplex/dataHere, 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