| ... | ... | @@ -6,12 +6,24 @@ LA Referencia, junto a [OpenAIRE](https://www.openaire.eu/), está llevando a ca |
|
|
|
|
|
|
|
> Nota: tarea relacionada [#92](https://github.com/crai-unrn/DSpace/issues/92)
|
|
|
|
|
|
|
|
## Índice
|
|
|
|
- [DSpace Usage Stats Collector](#dSpace-usage-stats-collector)
|
|
|
|
- [Objetivo](#objetivo)
|
|
|
|
- [Diseño y desarrollo](#diseño-y-desarrollo)
|
|
|
|
- [Aspectos destacados](#aspectos-destacados-del-recopilador)
|
|
|
|
- [Instalación](#instalación)
|
|
|
|
- [Requerimientos previos](#requerimientos-previos)
|
|
|
|
- [Instalar con script](#instalar-con-script)
|
|
|
|
- [Instalar sin script](#instalar-sin-script)
|
|
|
|
- [Post instalación](#post-instalación)
|
|
|
|
|
|
|
|
## DSpace Usage Stats Collector
|
|
|
|
El **Recopilador de estadísticas de uso de DSpace** es un agente de [Python](https://www.python.org/), cuyo propósito es la recopilación y envío de eventos de estadísticas de uso de DSpace a [Matomo](https://matomo.org/)/OpenAIRE, para su futuro procesamiento y análisis.
|
|
|
|
|
|
|
|
- Software libre: GNU General Public License v3
|
|
|
|
- Documentación: <https://dspace-stats-collector.readthedocs.io>
|
|
|
|
|
|
|
|
### Objetivo
|
|
|
|
El recopilador envía datos de uso de los repositorios a un servidor regional externo mediante la emisión de consultas de solo lectura al subsistema de estadísticas [DSpace Solr](https://wiki.lyrasis.org/display/DSDOC6x/SOLR+Statistics).
|
|
|
|
De esta forma, permite compartir datos sobre el acceso a elementos en repositorios, tales como revistas electrónicas y [sistemas CRIS](https://es.wikipedia.org/wiki/Sistema_de_informaci%C3%B3n_de_investigaci%C3%B3n_actual), con el fin de apoyar la evaluación, gestión y presentación de informes.
|
|
|
|
|
| ... | ... | @@ -19,6 +31,7 @@ El éxito de esta prueba depende de la instalación del componente recopilador e |
|
|
|
|
|
|
|
Este desarrollo es parte de las tareas de LA Referencia en el proyecto OpenAIRE Advance, cuyo objetivo es construir un piloto sobre el intercambio de datos de uso entre las infraestructuras de ciencia abierta de América Latina y Europa.
|
|
|
|
|
|
|
|
### Diseño y desarrollo
|
|
|
|
El diseño y el desarrollo de este agente recopilador se basó en los siguientes principios:
|
|
|
|
- Desarrollo colaborativo de código abierto
|
|
|
|
- Procedimiento de instalación sencillo para usuarios de Linux no expertos sin privilegios de root o superusuario
|
| ... | ... | @@ -42,16 +55,12 @@ En esta primera versión del agente, se implementaron las siguientes etapas para |
|
|
|
Para la prueba piloto es necesario:
|
|
|
|
- El repositorio se ejecute bajo el software DSpace en sus versiones 4, 5 o 6.
|
|
|
|
- Contar con un ID de OpenDOAR. Ejemplo para el RID-UNRN: <https://v2.sherpa.ac.uk/id/repository/4369>
|
|
|
|
- Verificar si las librerías wget y cron están instaladas en servidor
|
|
|
|
|
|
|
|
### Verificar si las librerías wget y cron están instaladas
|
|
|
|
```bash
|
|
|
|
apt-get install wget cron
|
|
|
|
```
|
|
|
|
|
|
|
|
### Instalar DSpace Usage Stats Collector según la guía oficial
|
|
|
|
### Instalar con script
|
|
|
|
Seguir las instrucciones de <https://dspace-stats-collector.readthedocs.io/en/latest/installation.html>
|
|
|
|
|
|
|
|
### Instalar DSpace Usage Stats Collector de otra forma
|
|
|
|
### Instalar sin script
|
|
|
|
> Nota: la instalación anterior es mediante la ejecución del script [install-standalone.sh](https://github.com/lareferencia/dspace-stats-collector/blob/master/install-standalone.sh). Como tuve muchos conflictos por temas de permisos, decidí descomponerlo.
|
|
|
|
|
|
|
|
#### Crear directorio para el recopilador
|
| ... | ... | @@ -84,23 +93,24 @@ wget https://raw.githubusercontent.com/lareferencia/dspace-stats-collector/maste |
|
|
|
./bin/dspace-stats-configure
|
|
|
|
```
|
|
|
|
|
|
|
|
### Configurar parámetros de Matomo
|
|
|
|
### Post instalación
|
|
|
|
#### Configurar parámetros de Matomo
|
|
|
|
Para conseguir la configuración necesaria, se deberá enviar un mail al SNRD (Alberto Apollaro o Paola Azrilevich) con el ID de OpenDOAR.
|
|
|
|
|
|
|
|
Una vez conseguida la información, actualizar el archivo `[dspace-stats-collector]/config/default.properties`
|
|
|
|
|
|
|
|
### Ejecutar el recopilador
|
|
|
|
#### Ejecutar el recopilador
|
|
|
|
```bash
|
|
|
|
./bin/dspace-stats-collector -v -f YYYY-MM-DD
|
|
|
|
```
|
|
|
|
> Cambiar YYYY-MM-DD por la fecha que se requiera recopilar y enviar eventos por primera vez
|
|
|
|
|
|
|
|
### Verificar envío de datos
|
|
|
|
#### Verificar envío de datos
|
|
|
|
Compruebe si el recopilador está enviando datos a la instancia de Matomo preguntando a su administrador de nodo nacional.
|
|
|
|
|
|
|
|
> **[!] Importante [!]**: no ejecutar el siguiente paso sin esta verificación
|
|
|
|
|
|
|
|
### Configurar Cron
|
|
|
|
#### Configurar Cron
|
|
|
|
El siguiente script agrega una entrada automáticamente en el crontab del usuario
|
|
|
|
```bash
|
|
|
|
./bin/dspace-stats-cronify
|
| ... | ... | |
