Installing TPC software

This page gives instructions on setting up your computer for using the software developed in Turku PET Centre. Instructions on software development are given elsewhere.

Windows

In VSSHP domain

In Turku PET Centre and hospital network the 32-bit versions of software are automatically installed (on mapped network drive P:\bin\windows), but if they are not, then contact the IT group.

If you have 64-bit Windows, you are by default still using the 32-bit versions of software. The 64-bit versions are located in P:\bin\win64, and to use those you need to add this directory to the PATH environment variable before the P:\bin\windows. Alternatively you can install the 64-bit versions of programs by following instructions below.

Outside VSSHP domain

If your computer is not in hospital domain, then download programs, and unzip the .exe files into a folder in your computer, preferably a folder which is dedicated only to TPC software, for example C:\Users\myname\bin If you have 32-bit Windows you must download 32-bit versions of software, otherwise either 32-bit and 64-bit versions can be used.

Add the folder to your computers PATH in order to use the programs from command-prompt window without specifying the path for programs each time: First, open the Windows Control panel. Then open the Environment Variables settings, and look if you can find a variable called PATH in the list for your user account. If it exists, then edit it, and if not then create it. Add to its value the path to the folder where you put the programs, starting with ; if variable PATH has previous content.

Linux

TPCCLIB binary package is built using Ubuntu (Debian) Linux, but it should work with other Linux flavours. Currently the binary package must be installed manually:

1. Create a folder for applications

Open the terminal window, and enter the following commands (modifying the path if necessary):

sudo -s mkdir /usr/local/bin/tpcclib
sudo -s chmod 777 /usr/local/bin/tpcclib

2. Add the folder to PATH environment variable

Open the hidden file .bash_profile, located in your home directory. For example, use command

leafpad ${HOME}/.bash_profile

Then add the following lines to the end of the file:

export PATH=${PATH}:/usr/local/bin/tpcclib

Save and close the file. To apply changes immediately enter this command:

source ${HOME}/.bash_profile

3. Copy the application binaries to the binary folder

First, download the binary package (tpcclib-*.*.*-Linux-x64.tar.gz).

Open the downloaded package, and find the bin folder inside it. Copy all applications files inside that folder into /usr/local/bin/tpcclib.

You can now use the applications in terminal window, regardless of the current working path.

MacOS

Currently, TPCCLIB binary package must be installed manually on macOS (OSX):

1. Create a folder for applications

Open the terminal window, and enter the following commands:

sudo -s mkdir /usr/local/opt/tpcclib
sudo -s chmod 777 /usr/local/opt/tpcclib

Obviously the installation folder can be set to something else then in example.

2. Add the folder to PATH environment variable

MacOS 10.15 Catalina uses zsh as the default shell instead of bash which used in previous macOS versions. Depending on the shell, the PATH must be set in different configuration file, .zshrc and .bash_profile for zsh and bash, respectively. Configuration files are located in your home folder, or if one does not exist, it can be created in there. Move into your home directory and edit or create the configuration file:

cd
nano .bash_profile

and edit or write the PATH setting to contain the TPCCLIB binary folder:

export PATH="/usr/local/opt/tpcclib:$PATH"

Then save the file in nano by clicking control+o and confirm the name of the file by hitting return. Exit nano with control+x.

The default shell has no effect on scripts, which will run in the shell defined in the beginning of the script (usually bash). To use bash by default, enter

chsh -s /bin/bash

3. Copy the application binaries to the binary folder

First, download the binary package (tpcclib-*.*.*-Darwin-x64.tar.gz) from a location mentioned in .

Open the downloaded package, and find the bin folder inside it. Copy all applications files inside that folder into the folder created above.

To apply changes in configuration file (above), enter this command:

source ${HOME}/.bash_profile

or relaunch the macOS Terminal. You can now use the applications in Terminal window, regardless of the current working path.


See also:



Tags: , , , , , ,

Updated at: 2020-04-14
Created at: 2016-11-17
Written by: Vesa Oikonen