NOTA: si ya tiene una versión anterior instalada por favor avisar al responsable nacional.
Instrucciones para desinstalar la versión anterior del dspace-stats-collector
Importante: antes de correr el comando asegurarse que curl está instalado en el sistema
curl --help
ATENCIÓN: Hemos creado un nuevo proceso de instalación basado en curl y una versión más antigua de miniconda para asegurar compatibilidad con versiones legacy de Linux.
Si experimenta errores con el proceso de instalación por favor comuníquese con el responsable nacional
Elija un instalador de acuerdo a la base de datos que su DSpace usa, SI NO ESTÁ SEGURO ELIJA LA VERSION POSTGRESQL
VERSION BASE POSTGRESQL ( 99% DE LOS CASOS)
!!!! Asegúrese de tener instalado curl antes de correr este comando, puede hacerlo ejecutando curl --help y verificando que produzca una salida válida
bash <(curl -L -s https://bit.ly/3OL8bNA)
VERSION BASE ORACLE ( CASO POCO FRECUENTE )
!!!! Asegúrese de tener instalado curl antes de correr este comando, puede hacerlo ejecutando curl --help y verificando que produzca una salida válida
bash <(curl -L -s https://bit.ly/3feiiOb)
El script iniciará descargando e instalando un ambiente Python (https://docs.conda.io/en/latest/miniconda.html) en el directorio home del usuario con que ejecutó el comando anterior. Este entorno no afecta a ningún paquete base del equipo ni alterará la versión de Python ya instalada. Todo el software instalado corre de manera independiente sin alterar el sistema base.
Continuará con la instalación de los paquetes Python requeridos.
Finalmente, se instalará el código de la aplicación, se creará el archivo de configuración default y se descargará la última versión del archivo COUNTER Robots (utilizado para la identificación de bots y de esta forma eliminarlos del conteo de estadísticas de uso).
https://www.youtube.com/watch?v=T5Bhf6Ek_u4
Ingrese a la dirección http://statsconfig.lareferencia.info/generator.html. Se le mostrará un formulario con 3 campos obligatorios:
ATENCIÓN: En caso de DSPACE CRIS debe ingresar como directorio base el directorio donde reside el código fuente, donde el instalador podrá acceder al build.properties
Luego de hacer clic en el botón ENVIAR, se descargará automáticamente el archivo default.properties con los datos específicos para que su repositorio DSpace pueda establecer comunicación con el Matomo de LA Referencia y enviarle estadísticas de uso.
Reemplace el archivo default.properties que se encuentra en el directorio dspace-stats-collector/config/
(*) Si desconoce el OpenDOAR ID de su repositorio siga los siguientes pasos:
2.1.1 Ingrese a https://v2.sherpa.ac.uk/opendoar/
2.1.2 Elija explorar el directorio por país
2.1.2 Al ingresar a la página de su repositorio, seleccione el apartado “Record Information”
https://www.youtube.com/watch?v=NF17Xc2DzZI
Seguidamente ejecute ./dspace-stats-collector -f YYYY-MM-DD. El parámetro -f especifica la fecha (año-mes-día) que marca el inicio del envío de datos a Matomo desde el repositorio DSpace.
CURRENT_USER_HOME/dspace-stats-collector/bin/dspace-stats-collector -f YYYY-MM-DD --verbose
Reemplace CURRENT_USER_HOME por el home del usuario que usó para la instalación
NOTA: para iniciar el envío de datos desde el 1de Enero de 2022, debiera ejecutarse el comando de la siguiente manera ./dspace-stats-collector -f 2022-01-01 --verbose desde el home del usuario que usó para instalar
https://www.youtube.com/watch?v=CZeafL52ngg
Una vez concluida la ejecución, puede revisar el archivo de bitácora creado en CURRENT_USER_HOME/dspace-stats-colector/var/logs/dspace-stats-collector.YYYY-MM-DD.log
NOTA: reemplazar ‘CURRENT_USER_HOME’ por el home del usuario que utilizó para ejecutar el comando de instalación.
Verifique si los datos fueron enviados con éxito al Matomo preguntando al responsable técnico nacional (por favor no ejecute el siguiente paso sin esta verificación).
El responsable nacional al ingresar a Matomo debe ingresar al menú Visitantes → Registro de visitas y allí filtrar según la fecha.
https://www.youtube.com/watch?v=Xn6RGCy93ik
Para instalar la tarea calendarizad (cron-job) que enviará datos automáticamente a Matomo, ejecute:
CURRENT_USER_HOME/dspace-stats-collector/bin/dspace-stats-cronify
Si no realiza esta tarea, el envío periódico no se realizará
*De acuerdo a las características de su repositorio, puede que sea necesario aumentar la frecuencia de envío de datos. En caso de tener un repositorio de grandes dimensiones consulte con su técnico responsable del nodo nacional.
https://www.youtube.com/watch?v=OM5HQC5faRU