Download

Documentation

Community

Development

  1. Installing Pydra
    1. Requirements
    2. Versions
      1. Stable Version
      2. Development Version (via git)
    3. Package Installation
      1. Installing From a Repository
      2. Installing From Tarball
    4. Configuring Your Installation
    5. Installing the Development Version

Installing Pydra

Requirements

Versions

Stable Version

Development Version (via git)

Package Installation

Installing From a Repository

  1. Follow your repository specific instructions for installation.
  2. Continue on to Configuring Your Installation

Installing From Tarball

Note: This portion of the guide assumes you have already set up MySQL, Python, Django, and Twisted

Download the latest stable version of Pydra with your web browser or wget 

wget http://pydra-project.osuosl.org/files/pydra/pydra-stable.tar.gz

Extract Pydra into its own directory and switch to that directory 

tar xzf pydra-0.5.tar.gz
cd pydra-0.5

run setup.py as root 

sudo ./setup.py

Installing from the tarball does not create groups, or setup permissions for running Pydra. It is strongly advised that you don't run Pydra as root. You should create a user for Pydra and assign permissions to the following directories:

  • /etc/pydra (read)
  • /var/lib/pydra (write)
  • /var/log/pydra (write)

Continue on to Configuring Your Installation

Configuring Your Installation

Create a mysql database, or database of your type. Go here for instructions on creating a mysql database

open /etc/pydra/pydra_settings.py to add your newly created database and username 

DATABASE_ENGINE = ''   <-- Change This to 'mysql', 'postgressql', or 'oracle'
DATABASE_NAME = ''     <-- Change This
DATABASE_USER = ''     <-- Change This
DATABASE_PASSWORD = '' <-- Change This
DATABASE_HOST = ''     <-- Change this (not needed if database is localhost)
DATABASE_PORT = ''     <-- Change this (not needed if database is localhost)

Run the following command to initialize the database. When prompted, create an admin user. This script offers all functions of the Django manage.py normally found within a django app. 

pydra_manage syncdb


Generate an SSL cert used by the Master to secure controller connections. Run generate_cert.sh and supply required information 

generate_cert.sh


At this point your master is ready. If you are using other machines as worker nodes in your cluster prepare those Worker Nodes by unpacking the release tarball on those servers. No configuration is needed for workers

When you have deployed the application to all of your workers you are ready to Start Pydra and then Configure Your Cluster

Installing the Development Version

To install from the working source tree, you must have  Git installed. The instructions to install from git are essentially the same as above, with a few exceptions

You can either install directly into your web directory, or elsewhere on the system and set up a symlink later(this method is preferrable). To get the latest source tree, run this command in the directory you wish to install into. 

git clone git://trac.osuosl.org/pydra.git

Follow the directions for installing from the stable version(with the exception of extraction from a tarball)

Anytime you wish to update your installation to the latest development version, simply run: 

git pull

For easier developing you should setup a development environment