DataONE Product Releases
=========================

DataONE maintains several "top-level" software products released for public consumption, 
in addition to the public code repository.  Released products include Metacat, GMN, 
d1_libclient_java, d1_common_java, d1_libclient_python, d1_common_python, and
the R-Client.

Below is a brief summary of where to find each, and a description of the release
process.  





d1_libclient_java
------------------
d1_libclient_java follows the generic versioning process, with releases being
built from the /tags directory in DataONE's code repository. Tagged versions
are built deployed to the project maven repository from the d1_libclient_java_STABLE
job on Hudson.  Those who use maven in their projects can add DataONE's repository
to their pom.xml files, and get access to the compiled artifact that way.

DataONE also supports users not using maven by creating and publishing an assembly
to releases.dataone.org/online

Each tagged version of libclient_java should be published here, and publishing
is a manual process.  To do the release::

1. complete the generic branching/tagging process in the code repository.
2. log into Hudson (as admin) and locate the d1_libclient_java STABLE job.
3. run the job, filling in the appropriate tag name at the prompt.
4. upon success, copy the resulting artifacts from the maven repository to the
   releases server:
   a). log into Hudson server:  ssh dev-testing.dataone.org
   b). navigate to libclient: cd /var/www/maven/org/dataone/d1_libclient_java
   c). locate the version, and copy it to releases.dataone.org
        (-SNAPSHOT versions as a rule don't get released)
        scp -rp 1.2.5 releases.dataone.org:
        (this copies into your home directory)
   d). log into releases server: ssh releases.dataone.org
   e). as root, move the version directory to the releases site:
        sudo mv 1.2.5 /var/www/releases/online/d1_libclient_java/
   f). confirm the deployment using your browser:
        http://releases.dataone.org/online/d1_libclient_java/
   g). sign off 
   
   
   
d1_common_java
--------------
not yet released


d1_libclient_python
-------------------
on pypy?

d1_common_python
-----------------
on pypy?

GMN
----
??

Metacat
-------
Maintained by NCEAS.


R Client
---------
Matt Jones is currently authorized to submit the dataone_R module to CRAN.  Instructions
and java dependencies are released to releases.dataone.org/online/dataone_r/