(c) Copyright 2016, 2017 Univa Corporation This software is licensed using Apache License 2.0 Please read the LICENSE file for a complete listing of the License.

UGE PyCL requires recent versions of the following software:

1. UGE (8.3.1p9, 8.4.0, or later)
2. Python (v2.7.5 or later in v2.7 series)
3. Setuptools (0.9.8 or later; for egg installation)
4. Nose (1.3.7 or later; for testing)
5. Sphinx (1.1.3 or later; for generating documentation)
6. Standard development tools (make)

The software versions listed above were used for prototype development and testing, on CentOS 7.2 (64-bit). It is likely that any recent version of Python (such as those that come with current linux distributions) should work. UGE versions 8.3.1p9 or later or 8.4.0 and later will work with the Configuration API. Minor modifications to the code that checks versions will have to be made to support versions greater than 8.4.0.

In the top level directory run:

  $ make 

The above command will create UGE PyCL egg package in the dist directory, which can be installed using the easy_install command. It will also run sphinx-build command and generate HTML documentation in the dist/doc/html directory.

For simple testing, without installing UGE PyCL egg package, do the following:

1. Setup PYTHONPATH environment variable to point to the top level directory:

  $ export PYTHONPATH=<UGE_PYCL_ROOT>

Note that the above step is not needed if UGE PyCL egg package is installed.

2. Source the appropriate UGE setup file:

  $ source <SGE_ROOT>/<SGE_CELL>/settings.sh

3. List queues using QconfApi object:

  $ python -c "from uge.api import QconfApi; api = QconfApi(); print api.list_queues()"

1. Setup PYTHONPATH environment variable to point to the top level directory:

  $ export PYTHONPATH=<UGE_PYCL_ROOT>

This step is not needed if UGE PyCL egg package is installed.

2. Source the appropriate UGE setup file:

  $ source <SGE_ROOT>/<SGE_CELL>/settings.sh

3. Run test suite:

  $ make test