| ... | ... | @@ -37,3 +37,73 @@ En esta primera versión del agente, se implementaron las siguientes etapas para |
|
|
|
- **Filtro de API de Matomo**: este filtro transforma los datos recopilados previamente en un conjunto de parámetros requeridos por [Matomo HTTP Tracking API](https://developer.matomo.org/api-reference/tracking-api)
|
|
|
|
- **Salida del remitente de Matomo**: este filtro almacena en un búfer y envía lotes de eventos al rastreador regional utilizando la función de seguimiento masivo de _Matomo HTTP Tracking API_
|
|
|
|
|
|
|
|
## Instalación
|
|
|
|
### Requerimientos previos
|
|
|
|
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
|
|
|
|
```bash
|
|
|
|
apt-get install wget cron
|
|
|
|
```
|
|
|
|
|
|
|
|
### Instalar DSpace Usage Stats Collector según la guía oficial
|
|
|
|
Seguir las instrucciones de <https://dspace-stats-collector.readthedocs.io/en/latest/installation.html>
|
|
|
|
|
|
|
|
### Instalar DSpace Usage Stats Collector de otra forma
|
|
|
|
> 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
|
|
|
|
```bash
|
|
|
|
mkdir /var/dspace/dspace-stats-collector
|
|
|
|
```
|
|
|
|
> Elegir el directorio que deseen
|
|
|
|
|
|
|
|
#### Descargar e instalar [Miniconda](https://docs.conda.io/en/latest/miniconda.html#linux-installers)
|
|
|
|
```bash
|
|
|
|
cd /var/dspace/dspace-stats-collector
|
|
|
|
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
|
|
|
|
|
|
|
|
bash Miniconda3-latest-Linux-x86_64.sh -b -f -p .
|
|
|
|
```
|
|
|
|
|
|
|
|
#### Instalar las dependencias de dspace-stats-collector
|
|
|
|
```bash
|
|
|
|
wget https://raw.githubusercontent.com/lareferencia/dspace-stats-collector/master/requirements.txt
|
|
|
|
./bin/pip install -r requirements.txt
|
|
|
|
```
|
|
|
|
|
|
|
|
#### Instalar paquete dspace-stats-collector
|
|
|
|
```bash
|
|
|
|
./bin/pip install dspace-stats-collector
|
|
|
|
```
|
|
|
|
|
|
|
|
#### Instalar archivos de configuración
|
|
|
|
```bash
|
|
|
|
./bin/dspace-stats-configure
|
|
|
|
```
|
|
|
|
|
|
|
|
### 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
|
|
|
|
```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
|
|
|
|
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
|
|
|
|
El siguiente script agrega una entrada automáticamente en el crontab del usuario
|
|
|
|
```bash
|
|
|
|
./bin/dspace-stats-cronify
|
|
|
|
```
|
|
|
|
|
|
|
|
> Nota: El recopilador se ejecuta cada 60 minutos de forma predeterminada |
