D-Net

services.aggregator.country					=	EU

services.oai.publisher.repo.email 				= dnet-admin@mock.it

# Properties

This file contains the list of properties that can be set to configure a D-Net instance.

To get the list of currently used properties please go to the Admin UI of your running instance and select Configuration > Container Properties

<table border=2>

<tr>

<th>Property name</th>

<th>Default value</th>

<th>Description</th>

</tr>

    <tr>

        <td>Foo</td>  <td>Foo</td>  <td>Foo</td>

    </tr>

</table>

# D-Net Software Toolikt

This is a minimal instance of the D-Net software toolkit, a software framework for the realization of aggregative data infrastructures.

Official Web Site: http://www.d-net.research-infrastructures.eu/

Features:

- Collection of metadata records in oai_dc format via OAI-PMH, xxx

- Transformation of the collected metadata records into an internal format named DMF (Driver Metadata Format)

- Indexing of DMF records into a Solr full-text index

- OAI-PMH exports of aggregated metadata records in DMF and oai_dc formats. More formats can be added at runtime by providing a dedicated XSLT from DMF to the desired target format.

Any questions, suggestions and feedback can be sent to dnet-team@isti.cnr.it.

# Installation requirements

This minimal instance can be run on a single machine as web application to be deployed on a Tomcat container. 

## Hardware requirements

Suggested minimal hardware requirements:

- SO

- CPU

- RAM

- HARD DISK space: heavily depends on the quantity and size of records you are going to harvest. See suggestions on instaling mongodb below.

## Software requirements

Software required:

* Apache Tomcat 7: the webapp container

* Mongodb >= 2.4: used to store the collected and transformed metadata records. Consider that each collected record will be stored in three separate "versions": original, transformed, pmh-ready, hence enough disk space should be available for mongoDB.

* Solr >= 4.9

Note that Tomcat, Solr and Mongodb can be installed in the same machine or in three separate machines.

#D-Net configuration

Before you start the web application, you need to configure at least the following properties.

For the full list of available properties and their values, check PROPERTIES.md.

Create a file named <code>cnr.override.properties</code> in <code>$yourTomcatHomeDirectory$/common/classes</code> (<code>$yourTomcatHomeDirectory$</code> will likely be something similar to <code>/var/lib/tomcat7</code>)

- <code>container.hostname</code>: the host name where the web app will be running. Default value is <code>localhost</code>. The default value should *only* be used in local development scenarios.

Example: <code>container.hostname = dnet-host.dnet.eu</code>

- <code>container.port</code>: the port where the web app will be running. Default is 8280.

Example: <code>container.port = 8080</code>

- <code>container.context</code>: the name of the web app (i.e. the name of the war file). Default is "app". The default value should *only* be used in local development scenarios.

Example: <code>container.context = is</code>

- <code>dnet.data.path</code>: path to the directory where all D-Net related resources will be saved. An embedded existDB will be automatically installed in this directory during the first start-up. The directory must be writable by the user running tomcat. Default value is <code>/tmp/dnet</code>. The default value should *only* be used in local development scenarios.

Example: <code>dnet.data.path = /var/lib/dnet</code>

- <code>services.aggregator.country</code>: your country code. Default is <code>EU</code> (Europe).

Example: <code>services.aggregator.country = IT</code>

- <code>services.aggregator.name</code>: the name of your aggregator. Default is "D-NET"

Example: <code>services.aggregator.name = TEST_Aggregator</code>. 

- <code>services.mdstore.mongodb.host</code>: the machine hosting mongodb for the storage of metadata records (M[eta]D[ata]Store). Default is localhost.

Example: <code>services.mdstore.mongodb.host = mongo.dnet.eu</code>

- <code>services.mdstore.mongodb.db</code>: name of the mongodb database to be used for the storage of metadata records. Default is "mdstore_minimal".

Example: <code>services.mdstore.mongodb.db = mdstore_1</code>

- <code>dnet.logger.mongo.host</code>: the machine hosting mongodb for the storage of workflow logs. Default is localhost.

Example: <code>dnet.logger.mongo.host = mongo.dnet.eu</code>

- <code>dnet.logger.mongo.db</code>: name of the mongodb database to be used for the storage of workflow logs. Default is "dnet_logs_minimal".

Example: <code>dnet.logger.mongo.db = dnet_logs_1</code>

- <code>services.oai.publisher.repo.name</code>: name of the OAI-PMH Publisher, as it will appear in the OAI Identify response. Default is "D-Net OAI-PMH Publisher".

Example: <code>services.oai.publisher.repo.name = TEST_Aggregator OAI-PMH Publisher</code>

- <code>services.oai.publisher.repo.email</code>: email of the OAI-PMH Publisher administrator, as it will appear in the OAI Identify response. Default is "dnet-admin@mock.it". The default *must not* be used in beta or production system for it is a mock email.

Example: <code>name.surname@valid.mail.com</code>

- <code>dnet.admin.password</code>: md5sum of the password that will allow the user "admin" to login to the D-Net Admin UI. To generate the new password: <code>echo thePassword -n | md5</code>. Default is "dnet-minimal" (without double quotes). The default value *should always be overridden*.

Example: <code>dnet.admin.password = 5d1ed3888708c0f4cd46b29306a6b449</code>, where 5d1ed3888708c0f4cd46b29306a6b449 is the md5 for the string "pwd" obtained via the command <code>echo pwd -n | md5</code>.

- <code>service.solr.index.jsonConfiguration</code>: information about the Solr instance to be used to create full-text indices on the aggregated metadata records. Default value assumes a local Solr instance. Specifically:

<code>

{"id":"solr",\

	"address":"localhost:9983",\

	"port":"8983",\

	"webContext":"solr",\

	"numShards":"1",\

	"replicationFactor":"1",\

	"host":"localhost",\

	"feedingShutdownTolerance":"30000",\

	"feedingBufferFlushThreshold":"1000",\

	"feedingSimulationMode":"false",\

	"luceneMatchVersion":"4.9",\

	"serverLibPath":"../../../../contrib/extraction/lib",\

	"filterCacheSize":"512","filterCacheInitialSize":"512",\

	"queryCacheSize":"512","queryCacheInitialSize":"512",\

	"documentCacheSize":"512","documentCacheInitialSize":"512",\

	"ramBufferSizeMB":"960","mergeFactor":"40",\

	"autosoftcommit":"-1","autocommit":"15000",\

	"termIndexInterval":"1024","maxIndexingThreads":"8",\

	"queryResultWindowSize":"20","queryResultMaxDocCached":"200"} 

</code>

If you are not running the Solr service on the same machine where Tomcat runs, then you need to override the above configuration according to your Solr server installation.

Typically, changing <code>address</code> and <code>host</code> is enough if your Solr server is not configured for sharding and replication.

For more details refer to the Solr documentation.

# Launching the D-Net web app

The D-Net Software is developed in Java with Maven.

In this distribution you will find a ready-to-deploy war package.

Copy the war file into the Tomcat 7 <code>webapps</code> directory, ensure you have overridden the properties as explained in the previous section and restart Tomcat.

The webapp should be running at http://${container.hostname}:${container.port}/${container.context}

If you want to build the web app yourself, then keep reading...

## Maven settings

If you want to run the D-Net web app with the Tomcat7 plugin for maven or if you want to build the .war file to deploy on a running tomcat, 

then you should have installed maven3 and you must add the following repository into your <code>settings.xml</code>:

```

 <repository>

          <id>dnet-bootstrap-releases</id>

          <name>D-Net Bootstrap Releases</name>

          <url>http://maven.research-infrastructures.eu/nexus/content/repositories/dnet4-bootstrap-release/</url>

          <releases>

            <enabled>true</enabled>

          </releases>

          <snapshots>

            <enabled>false</enabled>

          </snapshots>

          <layout>default</layout>

 </repository>

```

We also suggest to add the Tomcat plugin to the plugins group at the bottom of the same file:

```

<pluginGroups>

    <pluginGroup>org.apache.tomcat.maven</pluginGroup>

</pluginGroups>

```

## Testing on local machine:

The D-Net Software is developed in Java with Maven. You can try out the D-Net web app on your local machine with the tomcat7 plugin.

```

> cd dnet-minimal-container

> mvn tomcat7:run

```

The webapp should be running at http://localhost:8280/app .

## Deployment on a Tomcat instance

The D-Net Software is developed in Java with Maven.

To build the war to use in a Tomcat 7 web app container:

```

 > cd dnet-minimal-container

 > mvn package

```

The .war file is then created into the <code>target</code> directory.