The Dataverse Network Project

The HANDLE.NET server provides the DVN with unique global IDs for each study in the DVN. Other ID registration services exist, but use of the HANDLE.NET service is encoded in the DVN-EAR files. The global study ID is stored in the DVN database, and on the HANDLE.NET global server as a full URL to the unique study.

To install and set up HANDLE.NET registration of global study IDs in the DVN:

1. Download the HANDLE.NET server.
   Refer to the HANDLE.NET software download page at http://handle.net/download.html.
2. Install the server in the production environment on the same the machine on which the GlassFish server is installed.
   Complete the installation and setup process as described in the HANDLE.NET Technical Manual, available on the Handle System web site at http://www.handle.net/tech_manual/Handle_Technical_Manual.pdf.
   Accept the default settings during installation, with one exception. Do not encrypt private keys, which can enable password prompts and defeat scripted set up and maintenance functions.
   During the set up you register for and receive an authority prefix, which the DVN uses to register the global IDs of studies.
   Note: The HANDLE.NET client libraries are part of DVN software. You do not need to install these libraries separately.
3. When the handleprefix entity object is deployed by the DVN-EAR file on the GlassFish server, the application creates the handleprefix table for that entity. This table defines the master authority registering through the DVN. For example, the master authority prefix for the IQSS DVN is 1902. (Note that the name registered with HANDLE.NET as this authority is VDCNetwork.)
   After you register for a HANDLE.NET authority prefix, enter the following SQL command to update the handleprefix table:
   insert into handleprefix (prefix) values( '<your HANDLE.NET prefix>');
4. The deployed vdcnetwork entity object creates the vdcnetwork table.
   Set the following values in this table to complete the HANDLE.NET service set up:
   • Set the handleregistration flag to true to enable use of HANDLE.NET to generate unique global IDs.
   • Change the authority prefix default value of Test to <your authority prefix>.
   • Accept the default value in the protocol column, hdl.
   • To register harvested studies, add the HANDLE.NET prefixes used for harvested studies to the handleprefix table.
     For each handle prefix, add a row to the table by using the following SQL command:
     update vdcnetwork set handleregistration=true, authority='<your HANDLE.NET prefix>';