Install DVN

General steps to install the DVN software are:

1. Install DVN application.
2. Install DSB services.
The default directory in which the DVN files are installed is <DVN>=/usr/local/VDC.

Read the following topics for detailed information about these steps:

Install the DVN Application

Perform the following steps to install the DVN application:

Download the DVN Application and Copy Files

Before you can install the DVN application, you must download the source files. Go to the official DVN SourceForge.net project site, http://sourceforge.net/project/showfiles.php?group_id=194383, and download the dvn package for the latest release. Be sure to download all files listed under the package, including the following:

• DVN-EAR_<version>.ear
• README_<version>.txt
• config_<version>.zip
• referenceData_<version>.sql
• buildupdate_<version>.sql  (Updates only; not needed for fresh installations)

Then copy the configuration and driver files:

1. Extract the config_<version>.zip file.
2. Copy the files in /<DVN>/working_directory and paste them in the following location:

   /<glassfish>/domains/domain1/config
3. Copy the PostgreSQL JDBC driver jar file from the directory 
/<DVN>/doc/PostgresDriver and paste it in the following directory:

   /<glassfish>/lib
   
An example driver is:

   postgresql-8.3-603.jdbc4.jar

Install and Set Up the DVN Application

Install and set up the DVN application as follows:

1. Extract the DVN .jar or .tar archive file on the server.
   The installation script creates and installs to the correct file. After installation, you can remove the original .jar or .tar file.
2. Open the GlassFish server Admin Console and set up a new Applications option for the DVN.
3. Deploy the DVN-EAR.ear application as follows:
   • Type - Enterprise Application (.ear)
   • Location - /<DVN>/DVN-EAR.ear

   When the application is deployed, the required database tables are created in PostgreSQL.

4. Using the admin tool that you downloaded with PostgreSQL, open the database and load and execute the referenceData.sql script.
   Type the following:
   psql -d <your database name> -f /<DVN>/referenceData.sql
5. In a browser window, open the DVN application at the following URL:
   http://<hostname>/dvn
   Log in by using networkAdmin as both the user name and password.
6. Change the default password and default e-mail address.
   Click the networkAdmin link on the right side of the main menu, and then click Update Account.

To change any other default settings (banner, footer, about page, and so on), or to create dataverses and start uploading studies and data files, see the Dataverse Network user guides.

Install the DSB Services

Perform the following steps to install the DSB services:

Download the DSB Code

Before you can use the DVN application, you must download the latest dvn-dsb.

Go to the official DVN SourceForge.net project site, http://sourceforge.net/project/showfiles.php?group_id=194383, and download the
dvn-dsb package. Be sure to include the following:

• DVN-DSB-<version>.rpm
• README-DSB-<version>.txt

Install and Set Up the DSB Services

To install the DSB services:

1. Install the rpm on the server.
   For example, type:
   rpm –ivh DVN-DSB-1.1-16a.i386.rpm
   The rpm installs automatically into <DSB>=/usr/local/VDC.
2. Configure Apache (httpd) to work with the installed DSB components.
   For ease of maintenance this configuration is isolated in a standalone file located in the main DSB installation tree. This configuration must be included in the main Apache configuration.
   Create a file called /etc/httpd/conf.d/00-vdc.conf with the following line in it:
   Include /<DSB>/etc/vdc.conf
   Then, restart httpd.
   A sample copy of 00-vdc.conf is included in the directory /<DVN>/etc.
3. Verify that all components are present and functioning properly by checking the DSB Diagnose verb.
   Type the following command:
   http://<hostname>:[port]/VDC/DSB/1.0/Diagnose
   This command reports any missing or malfunctioning components.