Changes between Initial Version and Version 1 of PythonMw


Ignore:
Timestamp:
Jul 25, 2008, 2:43:56 PM (16 years ago)
Author:
davea
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • PythonMw

    v1 v1  
     1= PyMW - Master Worker Computing in Python =
     2
     3PyMW (Master Worker Computing in Python) PyMW is a Python module for parallel master-worker computing in a variety of environments, including BOINC. With the PyMW module, users can write a single program that scales from multi-core machines to global computing platforms.
     4
     5== Download ==
     6
     7PyMW can be downloaded from [http://pymw.sourceforge.net/ here].
     8
     9== Installation ==
     10
     11A BOINC project has to be prepared to accept applications written in Python. BOINC comes with an install script for PyMW. The setup script - pymw_setup.py - can be found in the bin directory of the BOINC project. An absolute path to the PyMW working directory has to be provided with the -p or --pymw switch to the setup script. The assimilator program for PyMW will copy the results to this directory. Example to run the setup script:
     12{{{
     13cd /home/kadam/projects/sandbox/bin
     14pymw_setup -p /home/kadam/pymw/examples/tasks
     15}}}
     16
     17The PyMW setup script executes the followings, respectively:
     18 * Insert pymw_assimilator in the daemons section of config.xml
     19 * Insert pymw application in project.xml
     20 * Create pymw directory in the app directory of the project
     21 * Create client application executables for Linux platform
     22 * Create client application executables for Windows platform
     23 * Call xadd
     24 * Call update_versions
     25
     26== Platforms ==
     27
     28By default PyMW assumes that the python interpreter is installed on the client computers. The Python interpreter is more likely to be installed on linux clients. On Windows PyMW assumes that Python is installed and the path environment variable contains the path to the interpreter. If python is installed on a windows box, but it's not in the path, than PyMW will look in the default installation directory, which is C:\Python25 with the current version of Python.
     29
     30OS X client is coming soon.
     31
     32If python is not installed on the client computer, PyMW jobs will fail. The [http://www.python.org/psf/license/ license of Python] makes it possible to deploy the interpreter as part of the client application, however the current version of the interpreter is about 35 MB, which is not very network friendly.
     33A later version of PyMW will come up with a solution that transfers the interpreter compressed over the network to reduce network load, but make PyMW widely available.
     34
     35== Usage ==
     36
     37Once successfully executed, the project is ready to handle PyMW jobs. The setup script can be called multiple times. However, if the pymw client application is already registered with the project, the setup script will only alter the working directory of the pymw_assimilator in the config.xml file.
     38
     39To use PyMW with the BOINC interface PyMW has to be configured with the -i or --interface switch. Also the home directory of the BOINC project needs to be passed to PyMW with the -p or --project_home switch.
     40Example to run PyMW with the BOINC interface:
     41{{{
     42cd /home/kadam/pymw/examples
     43python monte_pi.py -i boinc -p /home/kadam/projects/sandbox/
     44}}}
     45For further information on using PyMW, please refer to the documentation of PyMW.