EDRN Sync Services
Project description
EDRN Sync provides an API for slurping up DMCC RDF representing EDRN users and groups and registering those users into our EDRN IC LDAP server.
Installation
This document tells you how to install edrn.sync.
Quick Instructions
Run:
pip install edrn.sync
What? You don’t have pip? You’re seriously still using easy_install? Sigh:
easy_install edrn.sync
That’s it. (Of course, you might want to put it into a buildout or a virtualenv).
Full Instructions
edrn.sync requires the Python programming language. We recommend version 2.4 or later. As of this writing, 2.7 is the latest stable version. If Python is not yet installed on your system, you can find binary and and source distributions from the Python website.
To test if a correct version of Python is available on your system, run:
python -V
You should see output similar to:
Python 2.7
indicating the version of Python installed. edrn.sync also requires Agile OODT. OODT is Object Oriented Data Technology, a framework for metadata and data grids. Agile OODT is a Python version of OODT that supports higher performance and easier integration than the Java version.
By far the easiest, recommended, and encouraged way to install edrn.sync is to use pip. If your Python installation has pip available to it (and all virtualenvs do), then this one command is all you need to run in order to download, build, install, and generate command-line tools all in one go:
pip install edrn.sync
That will also download and install all dependencies, including Agile OODT.
Executables
The commands dmccsync and dmccgroupsync will be generated and placed with your standard installation directory for Python commands. Usually, this is the same location as the python executable itself.
Issues and Questions
To report any problems with or ask for help about edrn.sync, visit our contact web page.
Using EDRN Sync Services
Installing the EDRN Sync Services package makes available the following commands on your computer:
- dmccsync command
The dmccsync command lets you slurp up a DMCC RDF file containing users that need to be entered into EDRN IC LDAP.
- dmccgroupsync command
Takes a DMCC RDF users file and a sites file and imports the associated PI groups and collaborative groups into the EDRN IC LDAPS server.
Changelog
1.0.3 - Holding Onto Heather’s Changes
This release addresses the following issue:
CA-1022 - Preserve people manually added to groups
1.0.2 - Where’s My Chair?
This release addresses the following issues:
CA-1020 - dmccgroupsync script ignores chair, cochair, consultant; it adds only “member” to collaborative groups
1.0.1 - Fixed URL
This release fixes the download URL of the package.
1.0.0 - All Official-Like
This release marks an official release of edrn.sync for use with the EDRN Directory Service.
0.0.1 - Kumbaya
This release adds group creation programs and APIs including the dmccgroupsync script which implements Heather Kincaid’s algorithm for adding groups and syncing them based on the DMCC RDF. For more information see https://oodt.jpl.nasa.gov/jira/browse/CA-669.
For the issue tracker, see http://oodt.jpl.nasa.gov/jira/browse/CA.
0.0.0 - Initial
This is an initial release of EDRN (EDRN) Sync Services supporting minimal dmccsync functionality.