RView 9 Installation Instructions

Below are sections providing machine specific instructions on installing rview and information about activation keys:

1. Windows Systems

2. Linux Systems RHEL and Ubuntu

3. MACOS systems

4. Information on Key files and rview activation



RView on 32/64 bit windows

  i) Download and copy the installer executable (from the url I emailed you) onto your desktop, eg:

     rviewqtWinInstall_9.073BQT_34534523198966.exe

  ii) Run the install executable

  Notes on this step:

    Make sure you have appropriate permissions to install software on your machine.
    When installing a key you may have to run rview with Administrator Privalages.

    On Windows 7 and 8 security imposed by the OS and different virus software has stooped programs from modifying their install (eg for key installation)
    This may mean that it is better to install rview in a folder not in "Program Files": Instead make a Folder "C:\MyProgramFiles" and then install rview in there.

  iii) Click through the installation steps to specify install location etc.

  iv) Run rview from the rview item installed on the programs menu

  v) email me the ID number to get a free activation key

  vi) Save the key file you receive back from me onto the desktop.

  vii) Drag and drop the key file from the desktop into the main rview window (not the text error window!) to install the key.

  More Notes:

    Activation keys sometimes fail after you apply a major windows patch: just email me the new ID if this happens!


RView on Ubuntu

i) For 64 bit ubuntu, first install 32 bit support:

  sudo apt-get install ia32-libs

Note: for earlier ubuntu's you may also need to install openmp (lib32gomp1)

ii) unzip the install package (from the url I emailed you) to a folder in your path:

   cd ~/bin

  unzip rviewqtLinCoreInstall_9.011BQT_4565543344.zip

This should place the executable on in the bin folder along with the rvlib directory:

   rviewqt

   rvlib

 iii) run rview using the full path eg:

    ~/bin/rviewqt

 iv) Send the ID number displayed to me by email to get an activation key!

 v) When you get the activation key back from me, simply drag and drop the key file into the main rview window to install in the rview install directory.

Notes:

a) You need to run rview with its full path, or with its location in your current environment PATH so that it knows where to find the key file and configurations etc.

b) You can setup a shortcut on your desktop to run rview directly (eg ~/bin/rview) in the window manager. How to do this depends on you specific window manager.

c) When running rview from the command line, you can provide a command line argument to specify the image data to be loaded eg:

     ~/bin/rview  myimage.nii



RView on RHEL

i) For 64 bit RHEL, first install 32 bit libraries:

  sudo yum -y install glibc.i686 libgomp.i686 freetype.i686 pygobject2.i686  libSM.i686 libICE.i686 libXrender.i686 fontconfig.i686 libXext.i686 mesa-libGL.i686 mesa–libGLU.i686 libpng.i686

ii) unzip the install package (from the url I emailed you) to a folder in your path, say:

   cd ~/bin

  unzip rviewqtLinCoreInstall_9.011BQT_4565543344.zip

This should place the executable in the bin folder along with the rvlib directory:

   rviewqt

   rvlib

 iii) run rview using the full path from any directory eg:

    ~/bin/rviewqt

 iv) Send the ID number displayed to me by email to get an activation key.

 v) When you get the activation key back from me, simply drag and drop the key file into the main rview window to install in the rview install directory (not the text window displaying the info text).

Notes:

a) You need to run rview with its full path, or with its location in your current environment PATH so that it knows where to find the key file and configurations etc.

b) You can setup a shortcut on your desktop to run rview directly (eg ~/bin/rview) in the window manager. How to do this depends on you specific window manager.

c) When running rview from the command line, you can provide a command line argument to specify the image data to be loaded eg:

     ~/bin/rview  myimage.nii



RView on MACOS

i) Download the installation zip file (from the url I emailed you) and save it on your desktop eg:

    rviewqtMacOSInstall_9.011BQT_9849689898.zip

ii) Double click on this to unpack the file, which will create a app folder on your desktop:

    rviewqt.app

iii) Run this application by double clicking on the icon.

iv) This will then provide you with a machine ID which needs to be emailed to me for final activation.

v) When you get the rview activation key back from me by email, save it on the desktop

vi) Drag and drop the key file from the desktop into the rview main window (not the text window) to install the key.

(note: you can now move the application folder to another location if needed)


Information on Key Files and machine ID numbers

Rview is free! However, its distribution is controlled by key files. This is so that I can report back to people how many users there are (part of keeping ones job), and also not find that someone else has started to distribute rview under their own name (this has happened in the past!). Rview uses a key file to enable it to run on a particular machine. A key file is created for you based on the machine ID that is calculated when you first run rview on the new machine. You need to email me the ID number to get the key file. Key files are free and are available in unlimited numbers! If you want to install on another machine,  just install on that machine and then email me the new ID number.

NOTES:

1. If you have one install that is visible from multiple machines (eg in '/usr/local/bin/rview' or 'c:\Program Files\rview'), then you can store multiple ID's in that installation folder so that rview will run on many machines. If you install your key files by dragging and dropping key files on a particular host, then rview will simply add the new key file for a new machine to the list (rview.key) held in the install folder (as long as the new machine rview is running on can write to the install folder). Alternatively you can simply add the new key file manually as a new line in the list in the rview.key file using a text editor (do not save as a .doc or .txt file when doing this!).

2. Sometimes your machine ID may change and rview stops running! This may be due to changes in your systems hardware or software configuration (eg wifi or internet connections, the use of VPN software or patches applied to the operating system). In this case simply email me the new ID key. If you would like me to look at why the ID has changed so that it does not happen again, email me and I will try and sort it out if you can send me some information about your machine.