Module xg

PyXG provides a python interface to Apple's Xgrid.

Xgrid is Apple's software for building and managing clusters of Macintosh computers for use in high performance computation. See http://www.apple.com/server/macosx/features/xgrid.html for more details.

Features

1. Use Xgrid from within python scripts as well as in interactive python sessions.
2. Create, submit and manage simple (one task) and batch (many task) Xgrid jobs using python's elegant syntax.
3. Work with multiple Xgrid controllers simultaneouly.
4. List available grids for each controller and query their status.

Quick Start

>>> from xg import *
>>> conn = Connection(hostname='xgrid.work.com',password='secret')
>>> cont = Controller(conn)

>>> cont.gridIDs()
(0, 3)

>>> cont.grids()
[<Grid with gridID = 0>, <Grid with gridID = 3>]

>>> g = cont.grid(0)
>>> g.jobIDs()
(229, 230, 231, 232)

>>> g.printJobs()
##################################################
id   Date Started             Status     CPU Power 
##################################################
229  2005-12-22 11:18:47 -0800 Finished   0         
230  2005-12-22 11:18:50 -0800 Finished   0         
231  2005-12-22 11:18:52 -0800 Finished   0         
232  2005-12-22 11:18:55 -0800 Finished   0

>>> j = g.job(229)      
>>> j.printInfo()
{
    name:  /usr/bin/cal
    jobStatus:  Finished
    taskCount:  1
    undoneTaskCount:  0
    percentDone:  100
}

>>> j.printInfo(verbose=False)
229  2005-12-22 11:18:47 -0800 Finished   0

>>> j.printSpecification()
{
    applicationIdentifier :  com.apple.xgrid.cli
    taskSpecifications :  {0 = {arguments = (); command = "/usr/bin/cal"; }; }
    name :  /usr/bin/cal
    inputFiles :  {}
    submissionIdentifier :  abc
}

>>> j.results(stdout="job229.out",stderr="job229.err")
Job stdout saved in file: job229.out

>>> j = g.submit(cmd='/usr/bin/cal')
Job submitted with id:  234

>>> j.printInfo(verbose=False)
234  2005-12-22 13:09:52 -0800 Finished   0