CCPN Analysis .rpm packages
===========================
Daniel O'Donovan (djo35) 19th August 2010


These RPM packages have been built using Open SuSE 11.3 and have been
tested on Open SuSE 11.3, Fedora 13 in both 32 and 64 bits. It is expected
that these packages will run on all Red Hat based linux systems, but if
you run into any complications then please report these via the CCPNMR Jiscmail 
list or through the CCPN website http://www.ccpn.ac.uk, thanks.

Installing
----------

To install CCPN Analysis, download the *.rpm package for your platform, or if
you are feeling adventurous then maybe the *.src.rpm (source code rpm).

Unfortunately OpenSuSE rpms aren't 100% compatible with Fedora rpms due to 
niggly little things like install locations and dependency package names. If
you run into any issues then either ask us for a package for your system, 
build and install using the alternate python distutils package (*.src.tar.gz),
or 'force' the install by ignoring the dependencies and then installing them
manually (not recommended).

fc: Fedora / Red Hat based Linux
--------------------------------

Yum is the recommended program for installing packages on Red Hat / Fedora 
systems, though rpm will also work. Yum will automatically resolve the package
dependencies for you which is always nice. To install, simply issue

$ sudo yum --nogpgcheck install <most recent rpm>-fc{i386/x86_64}.rpm

NB - the '--nogpgcheck' command is important as currently CCPN packages aren't
signed. This will change in the future, but is needed here to prevent a

"Package ccpn-analysis-2.1.5-fc13.x86_64.rpm is not signed" type error.

To uninstall simply issue

$ sudo yum erase ccpn-analysis

suse: OpenSuSE based Linux
--------------------------

Yast is the recommended program for installing packages on Open SuSE systems, 
though rpm will also work. Yast will automatically resolve the package
dependencies for you which is always nice. To install, simply issue

$ sudo /sbin/yast2 --install <most recent rpm>-suse{i586/x86_64}.rpm

To uninstall simple issue

$ sudo /sbin/yast2 --remove ccpn-analysis

rpms in general
---------------

If for whatever reason neither of the above methods takes your fancy then please
feel at liberty to use the rpm package, but note that this will not necessarily 
install dependencies (such as Python and Python-Tkinter).

Updating
--------

CCPN Analysis will be installed to a read only directory, so to update
your release using the CCPN upgrade server start Analysis as root, updata
and then exit Analysis.

$ sudo analysis

< Now run the update mechanism and quit Analysis.>