Below are sections providing machine specific instructions on installing rview and information about activation keys:
2. Linux Systems RHEL and Ubuntu
4. Information on Key files and rview activation
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: 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!
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
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
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.