spacer spacer

Handle.Net® Software

The Handle.Net software (HN_v8.1) together with the documentation included with the software, is available under the Handle.Net Public License Agreement (Ver 1). Please read the license carefully before downloading the software.

Version 8.1.1 was released on April 18, 2016, fixing a bug with server startup on Windows machines and other minor changes as outlined in the Release Notes.

Release Notes

The Release Notes describe the features found in the latest version of the software, including a RESTful JSON-based HTTP API, a browser-based administrative client, an extension framework allowing Java® Servlet apps, authentication using handle identities without specific indexes, multi-primary replication, security improvements and a variety of tool and configuration improvements.

Upgrading to Version 8

We recommend that you upgrade to the latest version of the software, although your existing server directory will continue to function as it has in the past. There are multiple jar files included with the distribution. You will need to use them all. There was a startup script for version 7, bin/hdl-server, in the distribution. This has not changed in version 8.

Full migration instructions are in the README.txt included with the distribution.

Send any questions and comments to the HNR Administrator at hdladmin@cnri.reston.va.us.

-

Installation Notes

  • Handle servers should be installed by system administrators. It is very much like installing a Web server. The server should be installed on a machine with an Internet presence, which should be outside an organization's firewall. If it must be inside a firewall, then ports 2641 and 8000 need to be open to incoming and outgoing messages.
  • The download directory contains the software in Java™, and includes the Client Library — Java™ Version. The release includes an administrative client which enables identifier administration (creating, deleting, and modifying data); batch deposits, edits and deletions; creating prefixes and homing prefixes; and adding and deleting administrators and managing administrator permissions.
  • Version 8 will run on most platforms with Java 6 or higher.
  • Users are able to review the code and set up and configure the software, but will not be able to create or resolve handles until they agree to the Handle.Net Registry Service Agreement (HNRSA) and become a Local Handle Service provider. Instructions for how to register to become a Local Handle Service provider are included in the distribution.
  • Users who choose to become a Local Handle Service provider will be asked to send the sitebndl.zip file that was generated when the software was configured to the Handle.Net Registry Administrator. The sitebndl.zip file contains the information needed to create a prefix for the resolution service for which identifiers will be created.
  • Corporation for National Research Initiatives was allotted the credential "20" by the DONA Foundation. CNRI will issue prefixes derived from 20 to users of the HN_v8.1 software. The new prefixes will be of the form "20.500" followed by four or more digits, i.e. 20.500.1234. Prefixes issued under the older Handle System Service Agreement will remain in operation but that Agreement will no longer be available to new users of the software.
  • Download the Handle.Net logo.

March 21, 2017