Curso de Capacitación

Gestión de repositorios digitales con Eprints

Instalación de Eprints: Guía de instalación de Eprints versión

3.3.16 en ubuntu 18.04.04 LTS.

Guía de instalación de EPrints en Ubuntu/Debian

http://www.eprints.org

Ing. Ernesto Correa

marzo 2021.
 Guía de instalación de
EPrints
Requisitos de software

 Servidor web Apache (con mod_perl)

 Servidor y cliente MySQL
 Perl
 Ubunto 18.0.04 LTS

Instalación de EPrints en Ubuntu 18.0.04 vía comandos

Ingresar como super usuario: $ sudo su

1. Edite, como usuario root, el archivo "/etc/apt/sources.list" y agregue las líneas:

$ nano /etc/apt/sources.list

deb http://deb.eprints.org/3.3/stable/ ./

El primer comando actualiza la lista de paquetes y dependencias disponibles a través de las fuentes
registradas en el archivo sources.list.

CRTL + O (Guardar Cambios)

CRTL + X (Salir)

2. Ejecute los commandos como super usuario:

$ wget -O - http://deb.eprints.org/keyFile | apt-key add -

$ apt-get update
$ apt-get install eprints
$ apt-cache show eprints (Verificar la versions diponibles)

Definiendo contraseña y usuario para mysql.

MySQL.
$ mysql -u root -p

CREATE USER 'eprints'@'localhost' IDENTIFIED by 'Zp2rfaO3';

GRANT ALL PRIVILEGES ON *.* TO 'eprints2'@'localhost' WITH GRANT OPTION;
$ exit;

Fuente: https://wiki.eprints.org/w/Installing_EPrints_on_Debian/Ubuntu

1
 Creación de repositorios (comando epadmin create)

Una vez que está instalado correctamente el software EPrints, hay que proceder a crear un
repositorio. Antes de iniciar el proceso, debemos asegurarnos de que está iniciado el servidor
MySQL, luego hay que seguir los siguientes pasos: cambie al usuario eprints (creado durante la
instalación de EPrints), vaya al directorio eprints (probablemente share/eprints3 o opt/eprints3) y
ejecute.

$ su eprints
$ cd /usr/share/eprints3
$ ./bin/epadmin create

Como resultado se obtendrá una serie de prompts que habrá que ir respondiendo para
configurar el repositorio. Nótese que cuando se vea un valor entre [corchetes], es el valor por
defecto y puede seleccionarse simplemente pulsando la tecla “enter”.

Create an EPrint Repository

Please select an ID for the repository, which will be used to create a directory and identify the repository. Lower
case letters and numbers, may not start with a number. examples: "lemurprints" or "test3"

Archive ID? mirepo

 Nombre del repositorio en el sistema. Se recomienda utilizar un nombre corto

que sea fácil de recordar. Seguidamente, el sistema creará el directorio
archive/<archive_id>, donde se copiarán los archivos de configuración.

Configure vital settings? [yes] ? yes

 Teclee “yes” o pulse “enter” para realizar la configuración vital del repositorio.

Core configuration for mirepo

Please enter the fully qualified hostname of the repository.

For a production system we recommend against using the real hostname of the machine. Example:

mirepo.footle.ac.uk

Hostname? mirepo.univ.edu.ar

 Ingrese el URL que identificará al repositorio. Hay que asegurarse de disponer de

los DNS (Domain Name System) correspondientes apuntando al servidor web.

Please enter the port of the webserver. This is probably 80, but you may wish to run apache on a different port if
you are experimenting.

2
 Webserver Port [80] ?

 Por lo general, se acepta el valor por defecto. Si se quiere tener varias

aplicaciones corriendo en el servidor web, se recomienda instalar EPrints en un
puerto diferente al 80.

Please enter all the aliases which could reach the repository, and indicate if you would like EPrints to write a
Redirect Rule to redirect requests to this alias to the correct URL.

Some suggestions:

eprints.mydomain.com

eprints.mydomain eprints

mirepo.univ

mirepo

Enter a single hash (#) when you're done.

Alias (enter # when done) [#] ?

 Se puede introducir todos los alias que conducirán al usuario hasta el repositorio.
Ingrese el carácter numeral “#” cuando haya finalizado. Se deberá informar al
servidor DNS de estos alias. Por lo general, se acepta el valor por defecto, es decir,
no se ingresan alias.

Please enter the path part of the repository's base URL. This should probably be '/'.

Path [/] ?

 Acepte el valor por defecto.

If you will use https for your user pages (including login) enter the https hostname here, or leave blank when using
http only.

HTTPS Hostname [] ?

 Acepte el valor por defecto.

Administrator Email? admi@servidor.edu.ar

 Ingrese la dirección de correo electrónico del administrador del servidor web.

Esto permitirá a los usuarios ponerse en contacto con el responsable del sistema
en caso de que se produzca algún inconveniente en la prestación del
servicio.

3
 Enter the name of the repository in the default language. If you wish to enter other titles for other languages or
enter non ascii characters then you may enter something as a placeholder and edit the XML config file which this
script generates.

Archive Name [Test Repository] ? Repositorio Institucional MiRepo

 Ingrese el nombre completo del repositorio. Por defecto, este nombre se usará en
muchas de las páginas estáticas y en la barra de título del navegador web.

Write these core settings? [yes] ?

 Acepte el valor por defecto. De lo contrario, no tendrá efecto todo el proceso

realizado hasta el momento.

Configure database? [yes] ?

 Acepte el valor por defecto.

Configuring Database for: mirepo

 Acepte el valor por defecto.

Database Name [mirepo] ?

 Ingrese el nombre interno de la base de datos MySQL. Por lo general, se emplea el

mismo nombre que el ID del repositorio, pero no es necesario. ¡Cuidado! no debe
existir una base de datos con ese nombre. El comando epadmin se
encargará de crearla.

MySQL Host [localhost] ?

 Dirección del servidor de la base de datos. Si la base de datos está en la misma

máquina que la instalación de EPrints, acepte el valor por defecto.

You probably don't need to set socket and port (unless you do!?). MySQL Port (# for

no setting) [#] ?

 Acepte el valor por defecto.

MySQL Socket (# for no setting) [#] ?

 Acepte el valor por defecto.

Database User [mirepo] ?

 Nombre de usuario con el que se conectará a la base de datos. No es necesario

que exista el usuario, el comando epadmin se encargará de crearlo. Si éste ya
existiera, será reemplazado por epstats.

Database Password [WuHv7W4c] ?

 Ingrese una nueva password o acepte el valor por defecto.

Los datos de conexión de la base de datos se guardan en:

4
 /usr/share/eprints3/archives/bdigital/cfg/cfg.d/database.pl

Write these database settings? [yes] ?

 Acepte el valor por defecto.

EPrints can create the database, and grant the correct permissions.

Create database "mirepo" [yes] ?

 Acepte el valor por defecto. El comando epadmin se ocupará de generar la base

de datos y darle los permisos correspondientes. Si ya existiera la base de datos y el
usuario para el repositorio, responda “no”.

Database Superuser Username [root] ?

 eprints

Database Superuser Password? changeme

 Para crear la base de datos y el usuario, el comando epadmin necesita la

password MySQL del usuario epints. Sólo se utilizará para conectarse con MySQL y
crear la base de datos y el usuario con los permisos correspondientes.

Create database tables? [yes] ?

 Acepte el valor por defecto.

Create an initial user? [yes] ?

 Acepte el valor por defecto. Se creará un usuario inicial para el repositorio recién
generado.

Creating a new user in mirepo

Enter a username [admin] ? mirepo_admin

 Ingrese un nombre de usuario.

Select a user type (user|editor|admin) [admin] ?

 Ingrese un rol de usuario. Por lo general, se acepta admin (administrador).

Enter Password?

 Ingrese una password para el usuario definido.

Email? administrador@univ.edu.ar

 Ingrese una dirección de correo electrónico para el usuario definido.

Do you want to build the static web pages? [yes] ?

 Acepte el valor por defecto.

5
 Do you want to import the LOC subjects? [yes] ?

 Si se acepta el valor por defecto, se incorporará la clasificación temática de la

Biblioteca del Congreso de Estados Unidos (en inglés).
Do you want to update the apache config files? (you still need to add the 'Include' line) [yes] ?

 Acepte el valor por defecto.

[Mensaje final del proceso de creación]

6
 Configuraciones adicionales

Ahora realice los cambios necesarios en los archivos cfg.

Tenga en cuenta que cambiar la configuración de metadatos puede requerir la regeneración de las tablas de la
base de datos. epadmin erase_data solo regenerará las tablas de documentos y eprints. erase_data regenerará
todo. Estos también borran el contenido de las tablas y cualquier archivo cargado).

Asegúrese de que su archivo de configuración principal de apache contenga la línea:

$ sudo su

$ nano /etc/apache2/apache2.conf

Include /usr/share/eprints3/cfg/apache.conf

Luego ejecutar los siguientes comandos para iniciar y

detener Apache:

[root@eprints ~] service apache2 stop

[root@eprints ~] service apache2 start
[root@eprints ~] service apache2 reload (Opcional)

Finalizado el proceso de creación del repositorio, quedaría por habilitar el Virtual Host. Para ell
o, hay que agregar un enlace simbólico del archivo /etc/apache2/sites-available/eprints al directorio
/etc/apache2/sites-enabled/ y reiniciar el servidor web para que tengan efecto los cambios.

[root@eprints ~] a2ensite eprints

[root@eprints ~] a2dissite 000-default

[root@eprints ~] service apache2 reload

Ingresar al repositorio por medio de la navegación web, digitando la ip que se obtiene al ejecutar el
comando, desde la terminal de Ubuntu: ifconfig
Ejemplo: http://192.168.48.129/

Nota: para equipos locales es necesario incluir la ip y hostname dentro del archivo hosts de Windows
Ruta: C:\Windows\System32\drivers\etc\hosts
Editar el archive con un editor de texto: Sublime Tex o Notepad++ y agregar la siguiente línea:
192.168.48.130 bdigital.unan.edu.ni

7
Instalación de plugin de idioma, bazarlink, the Eprints flag pack
Ingrese como administrador a su repositorio.

Seleccione la opción: Administración, Herramientas del sistema y Bazar Eprints.

Localice los siguientes paquetes y de clic en Install

Esto cambiará automáticamente la interfaz en español y podrá observar un error en la página

principal.

Para corregir dicho error, váyase a la carpeta compartida a la ruta cfg(dentro de archives)\lang\es
Copie toda la carpeta static y súbala a
/usr/share/eprints3/archives/repositorio/cfg/lang/es

Con este habrá logrado corregir ese error.

8
Otro detalle a corregir al momento de instalar el paquete de idioma, es la palabra Browse que
aparece en el menú. Eprints maneja sus traducciones en la siguiente opción: Administracion,
configuracion, editar frases

Estando en la siguiente ventana

9
resione ctl +f busque la palagra Browse

y cámbiela por Buscar

Ahora podrá ver que en el menú dice:

Incorporación de campo Revista

En muchas ocasiones nuestras instituciones poseen revistas científicas. Y este campo lo podemos
añadir en eprints, por defecto no aparece.

Para incorporar el campo Revista siga los siguientes pasos.

1. Ingrese a la carpeta (Windows)

cfg(dentro de archives)\lang\es\phrases

y suba el archivo views.xml a la ruta

/usr/share/eprints3/archives/RepoUCC/cfg/lang/es/phrases

10
 2. Ingrese a la carpeta (Windows)
cfg(dentro de archives)\lang\en\phrases

y suba el archivo views.xml a la ruta

/usr/share/eprints3/archives/repositorio/cfg/lang/en/phrases

3. Ingrese a la carpeta (Windows)

cfg(dentro de archives)\cfg.d

y suba los archivos archivo views.pl y eprint_fields.pl, a la ruta

/usr/share/eprints3/archives/RepoUCC/cfg/cfg.d

Incorporación de template
Por defecto la carpeta template no aparece en la instalación original, por lo tanto es necesario subirla
para poder realizar personalizaciones al header y footer.

1. Ingresa la carpeta (Windows)

cfg(dentro de archives)\lang\es

y suba toda la carpeta templates a la ruta

/usr/share/eprints3/archives/RepoUCC/cfg/lang/es/

Y a la ruta

/usr/share/eprints3/archives/RepoUCC /cfg/lang/en/

Incorporar otros tipos de Tesis

Por defecto eprints trae ciertos tipos de Tesis y no aparece las opciones
Licenciatura o Ingeniería. Si usted quiere que añadir estos tipos de tesis haga lo siguiente:

1. Ingrese a la carpeta (Windows)

cfg(dentro de archives)\workflows\eprints

11
 copie el archivo default.xml y súbalo a

/usr/share/eprints3/archives/RepoUCC/cfg/workflows/eprint

2. Ingrese a la carpeta (windows)

cfg(dentro de archives)\lang\es\phrases

copie el archivo eprint_fields.xml y súbalo a

/usr/share/eprints3/archives/repoUCC/cfg/lang/es/phrases

Corregir error al momento de querer añadir material en cada registro

Como se apreció en la instalación, cuando instalamos el idioma español y quisimos realizar

ingreso, nos dio error al momento de querer seleccionar una materia. Para corregir eso haga
lo siguiente.

1. Ingrese a la carpeta
p_busquedas_materias

2. Localice el archivo Subject.pm

y súbalo a la ruta

/usr/share/eprints3/perl_lib/EPrints/Plugin/InputForm/Component/Field

3. Ingresa a la plataforma via web. Y vaya a la opción. Administración, configuración,

Actualizar base de datos

12
Ahora ingrese al servidor en línea de consola con el usuario eprints
Y ejecute los siguientes comandos

1. Regenere abstracts

2. Regenere vistas

3. Recargar configuración

Importación de Dewey y Árbol de Dependencias.

Si usted no va a trabajar con las materias de la biblioteca de congreso, pude importar el Dewey desde
el archivo subjectsDewey.xml, en este mismo archivo se construye el árbol de dependencias.

Para importar este archivo ejecute el siguiente comando:

13
/usr/share/eprints3/archives/repositorio/cfg/ (es la ruta donde dejé el subjectsDewey.xml). Puede
ser otra ruta.

Instalación del plugin estadístico IRStat2

Antes de instalar el plugin debe instalar las siguientes dependencias

apt-get install libgeo-ip-perl libdate-calc-perl

Ingrese a la plataforma web e instale el plugin

luego reinicie apache como root.

apache2ctl restart

IMPORTANTE:

Si no se pone el email al autor IRstats no lo toma como valido al momento de generar el ranking de
autores. Es necesario poner
Un email.

La actualización de las estadísticas se debe realizar manual o programar con cron,

para lo cual haga lo siguiente:

Ingrese a
/usr/share/eprints3/archives/RepoUCC/bin/stats

Edite
nano process_stats

Borrar la línea:
14
use lib "$FindBin::Bin/../../../../perl_lib";

y ahora ejecute el comando

su eprints
perl -I/usr/share/eprints3/perl_lib /usr/share/eprints3/archives/RepoUCC/bin/stats/process_stats
RepoUCC --setup –verbose

Para visualizar las estadísticas ingresar a

http://repositorio.una.edu.ni/cgi/stats/report

15