https://github.com/hotosm/osm-tasking-manager

Deprecated! - See osm-tasking-manager2
https://github.com/hotosm/osm-tasking-manager

Last synced: 1 day ago
JSON representation

Deprecated! - See osm-tasking-manager2

• Host: GitHub
• URL: https://github.com/hotosm/osm-tasking-manager
• Owner: hotosm
• Created: 2011-07-09T14:59:38.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2017-10-17T19:35:45.000Z (about 7 years ago)
• Last Synced: 2024-08-01T12:19:20.712Z (3 months ago)
• Language: CSS
• Homepage:
• Size: 38.7 MB
• Stars: 84
• Watchers: 14
• Forks: 25
• Open Issues: 97
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.txt

Awesome Lists containing this project

• awesome-starred - hotosm/osm-tasking-manager - Deprecated! - See osm-tasking-manager2 (others)

README

        
Deprecated

==========

**This repo is now deprecated in favor of** osm-tasking-manager2_

.. _osm-tasking-manager2: https://github.com/hotosm/osm-tasking-manager2

OpenStreetMap Tasking Manager

=============================

About

-----

OSMTM enables collaborative work on specific areas in OpenStreetMap by defining

clear workflows to be achieved and by breaking tasks down into pieces.

The application is written in Python using the Pylons framework.

Dependencies

------------

OSMTM has a set of dependencies that you need to install first.

On debian systems you can do::

    sudo apt-get install build-essential protobuf-compiler libprotobuf-dev libgeos-dev python-dev

On OS X you can do::

    brew install protobuf geos

Installation

------------

First clone the git repository::

    git clone git://github.com/hotosm/osm-tasking-manager.git

Update and load the submodules::

    

    cd osm-tasking-manager

    git submodule update --init

Installing OSMTM in a Virtual Python environment is recommended.

To create a virtual Python environment::

    wget http://pypi.python.org/packages/source/v/virtualenv/virtualenv-1.8.tar.gz

    tar xvzf virtualenv-1.8.tar.gz

    python virtualenv-1.8/virtualenv.py --distribute --no-site-packages env

    rm -rf distribute-0.6.28.tar.gz

    rm -rf virtualenv-1.8*

    source env/bin/activate

To install OSMTM from source (the only option at this point) in the virtual

Python environment execute the ``setup.py`` script::

    python setup.py install

Edit the development.ini file and change the ``admin_user`` variable to match

your OSM username. 

Run OSMTM

---------

To run OSMTM the easiest is to use ``pserve``::

    pserve --reload development.ini

Installation as a mod_wsgi Application

--------------------------------------

Edit the production.ini file and change the ``admin_user`` variable to match

your OSM username.

Install and enable mod_wsgi module in Apache::

    sudo apt-get install libapache2-mod-wsgi

Create a new Apache config file with the following::

    # Use only 1 Python sub-interpreter.  Multiple sub-interpreters                                                                                                                                                                                                                                                           

    # play badly with C extensions.

    WSGIPassAuthorization On

    WSGIDaemonProcess OSMTM_process user=ubuntu group=ubuntu processes=1 \

       threads=4 \

       python-path=/home/ubuntu/osm-tasking-manager/env/lib/python2.7/site-packages

    WSGIScriptAlias /OSMTM /home/ubuntu/osm-tasking-manager/env/OSMTM.wsgi

    WSGIRestrictStdin Off

    

        WSGIProcessGroup OSMTM_process

        WSGIApplicationGroup %{GLOBAL}

    

You may need to adpat the user, group and paths values.

Create a new `OSMTM.wsgi` in your virtual env directory with the following::

    

    import sys

    sys.stdout = sys.stderr

    from pyramid.paster import get_app    

    application = get_app(

        '/home/ubuntu/osm-tasking-manager/production.ini', 'main')

You can then test config and restart Apache.

Your application should be available at http://host.domain/OSMTM

You may also need to enable CORS. See http://enable-cors.org.

Add the following to your virtual hosts::

    Header set Access-Control-Allow-Origin "*"

Styles

------

The CSS stylesheet are compiled using less. Launch the following command as

soon as you change the css::

    lessc OSMTM/static/css/main.less > OSMTM/static/css/main.less.min.css

Run Tests

---------

To ensure your build is working properly run the tests (in active virtual env)::

    nosetests

Upgrade notes

-------------

Database versions are now managed using Alembic.

The following commands should help upgrading the database.

*Don't forget to make copies of your db file before running any upgrade.*::

    alembic upgrade head

Note: Please contact the maintainer if you encounter problems.