Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
This is PHP extensions goal is to provide just enough functionality to a web developer read data from the slurm controller daemon to create a *status* or *monitoring* application which can be viewed by the end user. All the code has been written by 'Vermeulen Peter' with contributions from TCHPC staff.
PHP C JavaScript
branch: develop
Failed to load latest commit information.
doc Sample makefile to generate phpdocs
etc Added basic spec file to build an RPM
examples Make sure people know that site is an example and fixed a comment whi…
tests
.gitignore Fix up release scripts, git archive doesn't like being run from a sub…
AUTHORS Add license, readme and release notes etc...
DISCLAIMER Add license, readme and release notes etc...
LICENSE Add license, readme and release notes etc...
NEWS small news file to note significant changes
README Fix up release scripts, git archive doesn't like being run from a sub…
RELEASE_NOTES Add license, readme and release notes etc...
VERSION Bumped version number to 1.0.2.1
bump-version
config.m4
php-slurm.spec Bumped version number to 1.0.2.1
release-stable.sh Tweak release script
release-unstable.sh Fix up release scripts, git archive doesn't like being run from a sub…
slurm_php.c remove another double free and do some strdup's
slurm_php.h Bumped version number to 1.0.2.1

README

Slurm PHP extension
===================

Requirements (tested with)

* SLURM 2.2.0
* PHP 5.1.6
* APACHE (optional, but recommended)

This was made primarily for SLURMWEB to connect to slurm. Any extra
interactions are welcome.

to compile...

phpize
./configure
make

this should make modules/slurm_php.so

make install as root
should install this where your extensions are in your php install

in your php.ini file add the line

extension=slurm_php.so

and you should be able to use the functions here.

Example PHP site
================

The examples directory contains a sample site which tries to show case
as much of the php functionality as possible.

Documentation
=============

The documentation can be created using PHPDocumentor 1.4.3, should you ever feel
the need to regenerate the documentation, use the following command

~~~~
phpdoc -o HTML:frames:phpedit -d examples -po c,includes,objects -t docs \
	-ti "php-slurm 1.0" 
~~~~

Administrator Notes
===================

To build an installable RPM from the tarball

~~~~
rpmbuild -ta php-slurm-1.0.tar.gz
~~~~

The above assumes that the appropriate compiler and rpm-build packages
are installed on your system.


TEST CASES
==========

It is assumed that the user has both slurmctld and slurmd is
configured up with at least 1 partition and 1 node for these tests to
pass.

Developer Notes
===============

The 'develop' branch should be used for development work and the 'master'
branch should always be a stable branch to make life easier for people
who want to roll out the package.

To clean up the directory to a clean state do the following

~~~~
phpize --clean
~~~~

The coding style that should be adopted is
http://www.kernel.org/doc/Documentation/CodingStyle


Doing a release
===============

* Finalise changes
* Run bump-version script to make some version number changes to various files
* Tag repository
* then run release-stable.sh to generate a tarball for redistribution
Something went wrong with that request. Please try again.