Revision 39169
Added by Claudio Atzori about 9 years ago
| README.md | ||
|---|---|---|
| 65 | 65 |
|
| 66 | 66 |
## Testing on local machine: |
| 67 | 67 |
The D-Net Software is developed in Java using Maven. You can try out the D-Net web app on your local machine with the tomcat7 plugin, provided you are also running a mongodb and a solr server on localhost that are listening to the relative standard ports. |
| 68 |
|
|
| 68 | 69 |
Please note that the solr client used in D-Net needs to interact with the zookeeper server. For simplicity we suggest to use the embedded zookepper instance provided within the solr distribution. By default solr listens on the 8983 port and its embedded zookeeper server on the 9983 port. |
| 69 |
To override properties, you can modify <code>dnet-minimal-container/src/main/resources/eu/dnetlib/cnr-site.properties</code>. Please check the Section D-Net Configuration and the PROPERTIES.md file for more information about D-Net properties. |
|
| 70 | 70 |
|
| 71 |
To override properties, you can modify <code>dnet-basic-aggregator/src/main/resources/eu/dnetlib/cnr-site.properties</code>. Please check the Section D-Net Configuration and the PROPERTIES.md file for more information about D-Net properties. |
|
| 72 |
|
|
| 71 | 73 |
``` |
| 72 |
> cd dnet-minimal-container
|
|
| 74 |
> cd dnet-basic-aggregator
|
|
| 73 | 75 |
|
| 74 | 76 |
> mvn tomcat7:run |
| 75 | 77 |
``` |
| ... | ... | |
| 93 | 95 |
52665 [Thread-7] INFO eu.dnetlib.enabling.is.store.TestContentInitializerJob - INITIALIZED |
| 94 | 96 |
``` |
| 95 | 97 |
|
| 96 |
The webapp should be ready and running at http://${container.hostname}:${container.port}/${container.context}
|
|
| 98 |
The webapp should be ready and running at |
|
| 97 | 99 |
|
| 100 |
``` |
|
| 101 |
http://${container.hostname}:${container.port}/${container.context}
|
|
| 102 |
``` |
|
| 103 |
|
|
| 98 | 104 |
If you want to build the web app yourself, then keep reading... |
| 99 | 105 |
|
| 100 | 106 |
|
| ... | ... | |
| 104 | 110 |
To build the war to use in a Tomcat 7 web app container: |
| 105 | 111 |
|
| 106 | 112 |
``` |
| 107 |
> cd dnet-minimal-container
|
|
| 113 |
> cd dnet-basic-aggregator
|
|
| 108 | 114 |
|
| 109 | 115 |
> mvn package |
| 110 | 116 |
``` |
| 111 | 117 |
|
| 112 |
The .war file is then created into the <code>target</code> directory.
|
|
| 118 |
The <code>.war</code> file is then created into the <code>target</code> directory.
|
|
| 113 | 119 |
|
| 114 | 120 |
#D-Net configuration |
| 115 | 121 |
Before you start the web application, you need to configure at least the following properties. |
| ... | ... | |
| 129 | 135 |
</br>Example: <code>services.aggregator.country = IT</code> |
| 130 | 136 |
- <code>services.aggregator.name</code>: the name of your aggregator. Default is "D-NET" |
| 131 | 137 |
</br>Example: <code>services.aggregator.name = TEST_Aggregator</code>. |
| 132 |
- <code>services.mdstore.mongodb.host</code>: the machine hosting mongodb for the storage of metadata records (M[eta]D[ata]Store). Default is localhost.
|
|
| 133 |
</br>Example: <code>services.mdstore.mongodb.host = mongo.dnet.eu</code> |
|
| 134 |
- <code>services.mdstore.mongodb.db</code>: name of the mongodb database to be used for the storage of metadata records. Default is "mdstore_minimal".
|
|
| 138 |
- <code>services.mdstore.mongodb.host</code>: the machine hosting mongodb for the storage of metadata records (M[eta]D[ata]Store). Default is <code>localhost</code>.
|
|
| 139 |
</br>Example: <code>services.mdstore.mongodb.host = mongodb.dnet.eu</code>
|
|
| 140 |
- <code>services.mdstore.mongodb.db</code>: name of the mongodb database to be used for the storage of metadata records. Default is <code>mdstore_minimal</code>.
|
|
| 135 | 141 |
</br>Example: <code>services.mdstore.mongodb.db = mdstore_1</code> |
| 136 | 142 |
- <code>dnet.logger.mongo.host</code>: the machine hosting mongodb for the storage of workflow logs. Default is localhost. |
| 137 | 143 |
</br>Example: <code>dnet.logger.mongo.host = mongo.dnet.eu</code> |
| ... | ... | |
| 141 | 147 |
</br>Example: <code>services.oai.publisher.repo.name = TEST_Aggregator OAI-PMH Publisher</code> |
| 142 | 148 |
- <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. |
| 143 | 149 |
</br>Example: <code>name.surname@valid.mail.com</code> |
| 144 |
- <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*.
|
|
| 145 |
</br>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>.
|
|
| 150 |
- <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 -n "thePassword" | md5sum</code>. Default is "dnet-minimal" (without double quotes). The default value *should always be overridden*.
|
|
| 151 |
</br>Example: <code>dnet.admin.password = 9003d1df22eb4d3820015070385194c8</code>, where 9003d1df22eb4d3820015070385194c8 is the md5 for the string "pwd" obtained via the command <code>echo -n "pwd" | md5sum</code>.
|
|
| 146 | 152 |
- <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: |
| 147 | 153 |
<code> |
| 148 |
{"id":"solr",\
|
|
| 149 |
"address":"localhost:9983",\ |
|
| 150 |
"port":"8983",\ |
|
| 151 |
"webContext":"solr",\ |
|
| 152 |
"numShards":"1",\ |
|
| 153 |
"replicationFactor":"1",\ |
|
| 154 |
"host":"localhost",\ |
|
| 155 |
"feedingShutdownTolerance":"30000",\ |
|
| 156 |
"feedingBufferFlushThreshold":"1000",\ |
|
| 157 |
"feedingSimulationMode":"false",\ |
|
| 158 |
"luceneMatchVersion":"4.9",\ |
|
| 159 |
"serverLibPath":"../../../../contrib/extraction/lib",\ |
|
| 160 |
"filterCacheSize":"512","filterCacheInitialSize":"512",\ |
|
| 161 |
"queryCacheSize":"512","queryCacheInitialSize":"512",\ |
|
| 162 |
"documentCacheSize":"512","documentCacheInitialSize":"512",\ |
|
| 163 |
"ramBufferSizeMB":"960","mergeFactor":"40",\ |
|
| 164 |
"autosoftcommit":"-1","autocommit":"15000",\ |
|
| 165 |
"termIndexInterval":"1024","maxIndexingThreads":"8",\ |
|
| 166 |
"queryResultWindowSize":"20","queryResultMaxDocCached":"200"} |
|
| 154 |
{"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"}
|
|
| 167 | 155 |
</code> |
| 168 | 156 |
|
| 169 | 157 |
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. |
Also available in: Unified diff
documentation details