Differences between revisions 2 and 13 (spanning 11 versions)
Revision 2 as of 2011-08-10 16:07:47
Size: 1892
Editor: mark
Comment:
Revision 13 as of 2013-05-17 14:28:11
Size: 4092
Editor: oliver
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Instalation = ## page was renamed from ScrumPy/InstallNotes
= Installation =
<<TableOfContents>>
Line 4: Line 6:
Line 9: Line 10:

Now cd into the freshly created directory and check the {{{install_conf.py}}} file. Then (as root)
Now cd into the freshly created directory then (as root):
Line 14: Line 14:
This will create a launcher script - {{{/usr/local/bin/ScrumPy}}} by default - which can be simply run from the command line.
Line 16: Line 17:
=== 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.
Line 17: Line 20:
{{{ScrumPy}}} should install on any Linux distribution, possibly after editing the configuration file [[ScrumPy/Doc/InstallConf|install_conf.py]], and probably on most other unix variants. Brief notes for installing on Red Hat derivatives can be found [[ScrumPy/Installation/RedHat|here]]
Line 18: Line 22:
=== OS ===

ScrumPy should install on any "Unix-like" system, possibly after tweaking the configuration files (see below).

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. 
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.
Line 25: Line 25:
Line 28: Line 27:
=== 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 (''after'' installing {{{ScrumPy}}}). Version 5.5 is reccomended. Later versions will ''probably'' be OK, but haven't yet been tested. When installing libsbml ensure you specify "--with-python" at the configuration stage. You will als need to run "ldconfig" once the installation is complete.
Line 30: Line 31:

All other dependencies are automatically taken care of by the install script.
All other dependencies are automatically taken care of by the install script, bit be sure to read the configutation instuctions below.
Line 35: Line 34:
=== 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.
Line 36: Line 37:
=== General === 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}}}
Line 38: Line 39:
Configuration details are held in the file {{{install_conf.py}}}. The default file is suitable for Debian and Ubuntu platforms (and most likely other Debian derivatives). === Other Options ===
The install script recognises two additioanl arguments which can appear anywhere on the command line : "NOPKG" and "LIBONLY".
Line 40: Line 42:
If the "NOPGK" argument is given none of the dependent packages will be installed. This will speed things a bit if you know that the packages are in place. Another time at which this might be useful is if you are installing as a non-root user. However, under these circumstances you will need write access in other places (see install_conf).
Line 41: Line 44:
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}}}
The "LIBONLY" compiles and installs the C extension modules without installing any Python. This is a development/maintaince option only.
Line 44: Line 46:
=== 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 Debian-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.
Line 45: Line 49:
=== Tweaking install_conf.py === Once installed {{{Scrumpy}}} can be run by simply entering {{{Scrumpy}}} at the command line. You should then see the main {{{ScrumPy}}} window shown below.
Line 47: Line 51:
'''Note''' {{{install_conf.py}}} is a Python module and needs to be syntactically correct. {{attachment:ScrumPyStart.png||width="600"}}
Line 49: Line 53:
For installation purposes there are only two places that might need editing: The list of packages to be installed and the command needed to install them. Both of these are self explanatory.









Further doccumentation continues [[ScrumPy/Doc/ModEnv#RunSpy|here]].

Installation

For the impatient

Down load the tarball and unpack:

$ 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 install_conf.py, and probably on most other unix variants. Brief notes for installing on Red Hat derivatives can be found here

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.

Python

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.

SBML

SBML functionality depends on libsbml libsbml . This is not distributed as part of ScrumPy, so must be installed separately (after installing ScrumPy). Version 5.5 is reccomended. Later versions will probably be OK, but haven't yet been tested. When installing libsbml ensure you specify "--with-python" at the configuration stage. You will als need to run "ldconfig" once the installation is complete.

Other dependencies

All other dependencies are automatically taken care of by the install script, bit be sure to read the configutation instuctions below.

Configuration

General

Configuration details are held in the file install_conf.py. The default file is suitable for Debian and Ubuntu platforms (and most likely other Debian derivatives). Follow the lik for explanations.

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

Other Options

The install script recognises two additioanl arguments which can appear anywhere on the command line : "NOPKG" and "LIBONLY".

If the "NOPGK" argument is given none of the dependent packages will be installed. This will speed things a bit if you know that the packages are in place. Another time at which this might be useful is if you are installing as a non-root user. However, under these circumstances you will need write access in other places (see install_conf).

The "LIBONLY" compiles and installs the C extension modules without installing any Python. This is a development/maintaince option only.

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 Debian-Squeeze. If you do get errors at this point check install_conf.py and if the problem remains unfixable, get in touch.

Once installed Scrumpy can be run by simply entering Scrumpy at the command line. You should then see the main ScrumPy window shown below.

ScrumPyStart.png

Further doccumentation continues here.

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