View source for Provider Registry and the HPD Profile

This page is to consolidate information about the HPD profile for implementation in the RHEA Provider Registry as we evaluate which technologies to use in Rwanda in as part of the Track 2 RHEA profile.

==DSML==
DMSLv2 is the XML format required by HPD to make queries and updates of the LDAP server
*[https://www.oasis-open.org/committees/dsml/docs/DSMLv2.xsd XSD] to validate a DSML document
*HPD Query Examples [[File:58-Provider_Information_Query_-_Req_and_Response_HPD_Examples.pdf‎]]
*HPD Feed Examples [[File:59-Provider_Information_Feed_-_Req_and_Ack_HPD_Exampels.pdf‎]]

==LDAP+DSML Servers and DSML Gateways==
There are several DSML gateways we can use to translate DSML to LDAP queries as well as LDAP servers that support DSML directly.  Here is a listing:
*[http://www.openldap.org/jldap/ JavaLDAP] 
*[http://opends.java.net/ OpenDS]
*[http://opendj.forgerock.org/ OpenDJ]
*[http://directory.apache.org/ ApacheDS] (not sure if does support DSML natively)

Note: we are currently using OpenLDAP as our LDAP server.

===Evaluation Criteria===
Here are some of the criteria to evaluate the DSML gateways / LDAP+DSML servers
*Server Type (DSML gateway vs. LDAP server with native DSML support)
*Open Source License
*Documentation Updated
*Active Development
*Ease of installation
**Availability on standard Linux platforms
**Requirements for configuration
*Speed/Performance Issues
**Memory Usage
*Ability to validate incoming DSML messages.  Example validations:
**does the hcidentifier attribute meet our format (e.g. hcIdentifier="id_type:id_number" or hcIdentifer="source:id_type:id_number:In/Active")
**can we validate coded lists (e.g. facility code)

===Evaluations===
====[http://www.openldap.org/jldap/ JavaLDAP]====
*Server Type (DSML gateway vs. LDAP server with native DSML support): '''DSML gateway'''
*Open Source License: '''OpenLDAP Public License v2.8'''
*Documentation Updated: '''Doesn't seem to have been updated recently'''
*Active Development: '''Last updated 6 Jul 2009'''
*Ease of installation: '''There are quite a few required supporting packages to install, but it shouldn't be difficult to install.'''
**Availability on standard Linux platforms: '''yes'''
**Requirements for configuration: '''Requires exteNd JBroker Web, ExteNd Application Server or Jakarta Tomcat 4.  Configure with servlet XML file for LDAP server details.'''
*Speed/Performance Issues
**Memory Usage
*Ability to validate incoming DSML messages.  Example validations:
**does the hcidentifier attribute meet our format (e.g. hcIdentifier="id_type:id_number" or hcIdentifer="source:id_type:id_number:In/Active")
**can we validate coded lists (e.g. facility code)

====[http://opends.java.net/ OpenDS]====
*Server Type (DSML gateway vs. LDAP server with native DSML support): '''LDAP server, however the DSML gateway is a separate package installed with a servlet engine'''
*Open Source License: '''[https://opends.dev.java.net/OpenDS.LICENSE Common Development and Distribution License (CDDL)]'''
*Documentation Updated: '''15 February 2012'''
*Active Development: '''Last Release: 6 October 2010, Last promoted build: 16 June 2010, Last source update: 6 months ago'''
*Ease of installation: '''Java Web Start or source code download, DSML gateway is a WAR file for use with a servlet engine'''
**Availability on standard Linux platforms: '''yes'''
**Requirements for configuration: '''[http://java.net/projects/opends/pages/2_2_DsSystemRequirements OpenDS System Requirements]'''
*Speed/Performance Issues
**Memory Usage
*Ability to validate incoming DSML messages.  Example validations:
**does the hcidentifier attribute meet our format (e.g. hcIdentifier="id_type:id_number" or hcIdentifer="source:id_type:id_number:In/Active")
**can we validate coded lists (e.g. facility code)

====[http://opendj.forgerock.org/ OpenDJ]====
*Server Type (DSML gateway vs. LDAP server with native DSML support): '''LDAP server with separate DSML gateway'''
*Open Source License: '''[http://www.opensource.org/licenses/CDDL-1.0 CDDL 1.0]
*Documentation Updated: '''16 January 2013'''
*Active Development: '''Xpress (beta?) release: 16 January 2013, Major release: 26 July 2012'''
*Ease of installation: '''Java Web Start installer or download source code'''
**Availability on standard Linux platforms: '''yes'''
**Requirements for configuration: '''Requires servlet engine for DSML gateway'''
*Speed/Performance Issues
**Memory Usage
*Ability to validate incoming DSML messages.  Example validations:
**does the hcidentifier attribute meet our format (e.g. hcIdentifier="id_type:id_number" or hcIdentifer="source:id_type:id_number:In/Active")
**can we validate coded lists (e.g. facility code)


====[http://directory.apache.org/apacheds/ ApacheDS]====
*Server Type (DSML gateway vs. LDAP server with native DSML support): '''LDAP server with native DSML support'''
*Open Source License: '''[http://www.apache.org/licenses/LICENSE-2.0 Apache 2.0] and [[http://svn.apache.org/viewvc/directory/shared/trunk/dsml/engine/src/main/java/org/apache/directory/api/dsmlv2/engine/ code]]'''
*Documentation Updated: 
**'''[http://directory.apache.org/studio/users-guide/ldap_browser/tools_dsmlimport_wizard.html import]'''
**'''[http://directory.apache.org/studio/users-guide/ldap_browser/tools_dsmlexport_wizard.html export]'''
**'''[http://directory.apache.org/api/gen-docs/latest/apidocs/org/apache/directory/api/dsmlv2/reponse/package-summary.html API]'''
**'''[http://directory.apache.org/studio/users-guide/Apache_Directory_Studio_LDAP_Browser_User_Guide.pdf Users Guide for Directory Studio]'''
**'''[http://directory.apache.org/apacheds/advanced-ug/2-server-config.html Server Configuration]to enable webserver to process DSML requests'''
*Active Development: '''Last commit 2 months ago'''
*Ease of installation: '''[[Installing_ApacheDS_On_Ubuntu]]'''
**Availability on standard Linux platforms: '''yes'''
**Requirements for configuration: '''[[Installing_ApacheDS_On_Ubuntu]]'''
*Speed/Performance Issues
**Memory Usage
*Ability to validate incoming DSML messages.  Example validations:
**does the hcidentifier attribute meet our format (e.g. hcIdentifier="id_type:id_number" or hcIdentifer="source:id_type:id_number:In/Active")
**can we validate coded lists (e.g. facility code)

==Resources==
*HPD Implementors [https://groups.google.com/forum/?fromgroups=#!forum/ihe-hpd-implementors Google Group]
*HPD Overview [[File:Provider_Registry_Overview_HPD.ppt‎]]
*Analysis of HPD with other standards [[File:IHE_HPD_Standards_TCON_01-19-10_v1.ppt‎]]
*Another [ftp://ftp.ihe.net/IT_Infrastructure/iheitiyr8-2010-2011/Technical_Cmte/Profile_Work/HPD/HPD%20Standards%20Analysis.doc of HPD] of HPD
*LDIF Schema for HPD -- [[File:hc.ldif]] and [[File:hpd.ldif]]