Set Up Optional Components

You can set up the following optional components to use in the DVN:

Configure HANDLE.NET

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>';

Configure Google Analytics

Network Admins can use the Google Analytics tools to view DVN website usage statistics.
Note: It take about 24 hours for Google Analytics to validate tracking of your website after registration of the DVN with Google Analytics. Your data is not available until that validation takes place.

To enable the use of Google Analytics from the Network Options page:

  1. Go to the Google Analytics homepage at http://www.google.com/analytics/indexu.html.
  2. Set up a Google account to access the Google Analytics website.
  3. Set up a Google Analytics account to receive a tracking code for your DVN installation.
  4. Copy the tracking code you are assigned and paste it into the content already provided by the DVN software. This ensures that your installation is tracked.
    Use the Google Analytics Help Center to find your tracking code and determine where to copy that code into your DVN content.
  5. Make sure that the GlassFish server configuration includes the JVM option
    -Ddvn.googleanalytics.key assignment for the tracking code. See Configure Application Server for JVM Options for details.