Differences between revisions 4 and 20 (spanning 16 versions)
Revision 4 as of 2012-09-03 15:18:32
Size: 2778
Editor: mark
Comment:
Revision 20 as of 2017-05-12 10:48:23
Size: 2175
Editor: noah
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Installation =
=== For the impatient ===
Down load the tarball and unpack:
## page was renamed from ScrumPy/InstallNotes
= Installing ScrumPy =
== Prerequisites ==
=== Operating Systems ===
The current version of !ScrumPy can be installed on Debian 8 (Jessie), Ubuntu 1404 (Trusty) or later and Centos 6. Debian 7 (Wheezy) will probably work, but may result in some loss of function and/or require manual intervention, Debian 6 (Squeeze) will only work with a lot of manual intervention and is deprecated. For installation on other Unix-like systems see [[ScrumPy/InstallConf|these notes]].
Line 5: Line 7:
{{{$ tar zxf ScrumPy.tgz}}}

Now cd into the freshly created directory then (as root):

{{{# python install.py}}}

This will create a launcher script - {{{/usr/local/bin/ScrumPy}}} by default - which can be simply run from the command line.



== Prerequisites ==
=== OS ===

We currently use debian/squeeze as our development platform, and if you have the choice this is reccomended as you should then be able to continue in impatient mode.

{{{ScrumPy}}} should install on any Linux distribution, possibly after editing the configuration file [[../Doc/InstallConf|install_conf.py]], and probably on most other unix variants.

We don't have a Windows version, and we are not currently planning one. If anyone is interested in porting ScrumPy to windows please get in touch. As far as I am aware, there are only two places in the source that would require modification, both of which are concerned with loading shared objects.
ScrumPy can also be installed natively on Windows 10. For [[http://mudshark.brookes.ac.uk/ScrumPyDoc/scrumpy-on-windows-may2017.pdf|walk-throughs]] on this, see these notes.
Line 25: Line 10:
Python 2.6 or 2.7 are recommended. 2.8 would ''probably'' be OK, but has not yet been fully tested, and may produce verbiage concerning Python 3 issues. Python 3 will almost certainly not (at present) work. ScrumPy will (currently) run on 2.5, but this is effectively obsolete and thus not recomended. !ScrumPy requires python 2.7 or 2.8. Python 2.6 ''might ''work but is long obsolete and not reccomended. Python 3 is not currently supported.
Line 27: Line 12:
=== SBML ===
SBML functionality depends on libsbml [[http://sbml.org/Software/libSBML|libsbml]] . This is not distributed as part of ScrumPy, so must be installed separately. Version 5.5 is reccomended. Later versions will ''probably'' be OK, but haven't yet been tested.
== Installation ==
Download the current [[http://mudsharkstatic.brookes.ac.uk/Download/ScrumPy.tgz|tarball]], unpack it and cd into the newly created ScrumPyXXXX directory (XXXX is the revision number). Then, as root, execute the install.py script. This will install a number of prerequisite packages which may take some time depending on what is already installed. A number of extension C libraries will also be compiled that may take a little time and generate a fair ammount of verbiage on the terminal. As long as the last line looks something like:
Line 30: Line 15:
=== Other dependencies ===
All other dependencies are automatically taken care of by the install script, bit be sure to read the
{{{ Makefails = [] }}} this output can safely be ignored.
Line 33: Line 17:
== Configuration ==
=== General ===
Configuration details are held in the file [[[/ScrumPy/Doc/InstallConf|install_conf.py]]. The default file is suitable for Debian and Ubuntu platforms (and most likely other Debian derivatives). Follow the lik for explanations.
!ScrumPy will now be installed in
Line 37: Line 19:
The file {{{install_conf_SUSE.py}}} is suitable for OpenSUSE (and likely SUSE as well) distributions. If using these then copy {{{install_conf_SUSE.py}}} to {{{install_conf.py}}} {{{ /usr/lib/python2.n/dist-packages/ScrumPy}}}, and a start script installed in
Line 39: Line 21:
{{{/usr/local/bin/ScrumPy}}}
Line 40: Line 23:
!ScrumPy can now be started by simply typing !ScrumPy at the command line. A few diagnostic messages will appear in the terminal, but these are for information only (see note on SBML below) and not errors.
Line 41: Line 25:
=== Initial testing ===
The ScrumPy installation script will produce a ''lot'' of verbiage on your terminal, however this mainly reportage/diganostic information related to the compilation of the varous C libraries. If you see explicit errors here, it is most likely due to missing or non-standard development packages. Another possibility is your C compiler is stricter than gcc 4.4.5 currently distributed with Squeeze. If you do get errors at this point check [[[/ScrumPy/Doc/InstallConf|install_conf.py]] and if the problem remains unfixable, get in touch.
Further documentation continues [[ScrumPy/Doc/ModEnv#RunSpy|here]].

== SBML support. ==
!ScrumPy uses libsbml to to read/write sbml format file. If libsbml is present in your distributions repository it will be installed automatically, otherwise libsbml will need to be installed manually from source (with the python option).

Installing ScrumPy

Prerequisites

Operating Systems

The current version of ScrumPy can be installed on Debian 8 (Jessie), Ubuntu 1404 (Trusty) or later and Centos 6. Debian 7 (Wheezy) will probably work, but may result in some loss of function and/or require manual intervention, Debian 6 (Squeeze) will only work with a lot of manual intervention and is deprecated. For installation on other Unix-like systems see these notes.

ScrumPy can also be installed natively on Windows 10. For walk-throughs on this, see these notes.

Python

ScrumPy requires python 2.7 or 2.8. Python 2.6 might work but is long obsolete and not reccomended. Python 3 is not currently supported.

Installation

Download the current tarball, unpack it and cd into the newly created ScrumPyXXXX directory (XXXX is the revision number). Then, as root, execute the install.py script. This will install a number of prerequisite packages which may take some time depending on what is already installed. A number of extension C libraries will also be compiled that may take a little time and generate a fair ammount of verbiage on the terminal. As long as the last line looks something like:

 Makefails = []  this output can safely be ignored.

ScrumPy will now be installed in

 /usr/lib/python2.n/dist-packages/ScrumPy, and a start script installed in

/usr/local/bin/ScrumPy

ScrumPy can now be started by simply typing ScrumPy at the command line. A few diagnostic messages will appear in the terminal, but these are for information only (see note on SBML below) and not errors.

Further documentation continues here.

SBML support.

ScrumPy uses libsbml to to read/write sbml format file. If libsbml is present in your distributions repository it will be installed automatically, otherwise libsbml will need to be installed manually from source (with the python option).

None: ScrumPy/Installation (last edited 2022-04-29 12:58:21 by mark)