Running TINA Under VMWare Player
VMware player is a free (for personal, non-commercial use) software product that allows Linux virtual machines to run under Windows, and can be used to run TINA. We do not recommended this for serious work (e.g. programming within TINA), but it can be useful as a method for trying out Linux/TINA without doing a full Linux installation, and at conferences or during presentations, to demonstrate TINA tools during Powerpoint presentations or whilst also demonstrating Windows software. It has several advantages:
This document provides instructions for how to install TINA under a VMWare Linux virtual machine. It assumes very little familiarity with the Linux operating system. The packages used were:
Windows Vista Home Premium 32 bit
VMware-player-3.1.0-261024.exe (VMWare Player 3.1.0 for Windows )
openSUSE-11.3-DVD-i586.iso (openSuse 11.3 32-bit .iso file)
tina-libs-6.0rcbuild004.tar.gz (TINA 6 libs libraries)
tina-tools-6.0rcbuild004.tar.gz (TINA 6 tools libraries)
volpack-1.0c7.tar.gz (Volume rendering library required by the TINA Manual Landmarking toolkit)
max_planck_toolkit-1.1.1.tar.gz (TINA Manual Landmarking toolkit)
Instructions for other systems may differ in detail, but should be broadly similar.
1) Download VMWare player from http://www.vmware.com/products/player/ (free registration required).
2) Install VMWare under Windows.
3) Download the openSuse DVD image from http://www.opensuse.org. Note that, if you are using a 32-bit windows installation you will need to use the 32-bit version of openSuse. It is possible to create a VMWare virtual machine directly from an ISO image; however, for the purposes of this guide I burned the image to disc.
4) Burn the openSuse ISO image to a disc e.g. using Nero under windows or k3b under Linux. Ensure that you do not burn a data DVD, but instead use the option to burn a disc image.
5) With the openSuse DVD in the DVD drive, start VMWare player and select the option to create a new virtual machine from the DVD. The installation procedure is almost entirely automatic; the only important user input required is a user name and password (do not lose these). Note that the password you select for the user is also used as the root password.
6) Download the latest TINA libs and tools library packages, the manual landmarking toolkit package, and the volpack volume rendering package from http://www.tina-vision.net/tarballs . Copy them to a USB memory stick.
7) Start VMWare and play the openSuse virtual machine. Click on the virtual machine window to send mouse and keyboard input to the virtual machine; you can switch back to windows by pressing Ctrl-Alt.
8) From within the virtual machine, click on Virtual Machine -> Removable Devices in the menu at the top of the window, and mount the USB stick containing the TINA packages (this will unmount it from Windows, and so you may get some Windows messages stating that a device is being removed). From within the virtual machine, start a File Manager (e.g. Dolphin), select the USB stick, and copy the TINA and volpack packages to your home area (e.g. /home/user_name, where user_name should be replaced with the user name you entered when you created the virtual machine).
9) Start a terminal in the virtual machine (e.g. click on the start button in the bottom-left hand corner of the window, select Applications->System->Terminal->Konsole). In the console, type
You will be prompted for the root password (it is the same as your user password). Enter it; if you are using Konsole, the prompt will change to red to remind you that you are logged into the terminal as root. Then type
mv /home/user_name/tina-libs-6.0rcbuild004.tar.gz ./
mv /home/user_name/tina-tools-6.0rcbuild004.tar.gz ./
This will create a directory to hold the Tina libraries, and move the Tina library packages to that directory. Then type
tar -xvf tina-libs-6.0rcbuild004.tar
tar -xvf tina-tools-6.0rcbuild004.tar
to uncompress the packages and extract their contents. This will create two sub-directories called tina-libs-6.0rcbuild004 and tina-tools-6.0rcbuild004. Type
This will build and install the tina-libs libraries. Assuming that you get no error messages, type
This will build and install the tina-tools libraries.
10) Again assuming that you got no error messages in the previous step, you can run the Tina example toolkit at this point; type
to switch back to your user account, and then type
Alternatively, you can run the example toolkit by clicking on the tinaTool executable file from within a file manager.
11) In the case that you want to run a Tina toolkit containing extra algorithmic functionality, you must also install the toolkit package and any other libraries it requires. This guide will use the Manual Landmarking toolkit as an example, as it illustrates the process of installing an additional library.
11a) To install an additional library (e.g. the volpack library in this example), start a terminal (or reuse the one from the previous step) and log onto it as root using the su root command as previously. Then type
mv /home/user_name/volpack-1.0c7.tar.gz ./
tar -xvf volpack-1.0c7.tar
This will move the Volpack package to the standard location for additional packages (the directory /usr/local), uncompress and extract the contents of the package to a new sub-directory, and then build and install the volpack volume rendering library. Then (whilst still logged into the terminal as root) type
This will update the system's list of runtime libraries to include the volpack library (note that in Linux, simply rebooting the machine will update the list of runtime libraries; however, in VMWare it seems that you have to do this explicitly).
11b) Now install the Tina toolkit package (max_planck_toolkit-1.1.1.tar.gz in this example). Unlike the TINA and volpack libraries, it is recommended that TINA toolkits should be installed into your home area. Start a terminal (or reuse the one from the previous steps). Do not log into it as root; if you are already logged into the terminal as root, then type
to switch back to your user account (if you are using Konsole, the prompt will be red if you are logged in as root and white if you are logged in as a normal user). The manual landmarking package should already be in your home area if you followed the instructions above. Type
to change directory to your home area, replacing user_name with the user name you entered when you set up the virtual machine. Then type
tar -xvf max_planck_toolkit-1.1.1.tar
to uncompress the manual landmarking package and extract its contents. This will create a sub-directory called max_planck_toolkit-1.1.1. Enter this sub-directory and build and install the manual landmarking toolkit by typing
The executable file will be installed in max_planck_toolkit-1.1.1/bin, and can be run by typing
or by clicking on the file within a file manager.
Note On Graphical Corruption
When TINA is run under VMWare, some Tv tools (e.g. the 2D Tvs of the manual landmark tool) may sometimes exhibit graphical corruption when the images they display are updated, which does not occur when the software is run under Linux. We are investigating a permanent fix for this problem but, until one is found, pressing the "Repaint" button in the affected Tv will redraw the image.
Update: the graphical corruption bug has been fixed in TINA libs and tools versions rcbuild005.