# HOW TO INSTALL SCIELO OPAC ON ROCKY LINUX

## Prerequisites

- An Rocky Linux system.
- A user with root or sudo privileges. This user will be used for installing new packages and make changes system-wide.
- Python 3.x (earlier version) and git command

## Getting the last version

- Dowloading the [newest release,](https://github.com/scieloorg/opac/releases) uncompress and move to the directory /usr/local/opac

```command
wget https://github.com/scieloorg/opac/archive/refs/tags/v3.4.51.tar.gz
tar -zxvf v3.4.51.tar.gz 
mv opac-3.4.51 /usr/local/opac
```

## Installing OPAC

- Create python environment and install using pip

```command
# Installing git command
dnf install git

cd /usr/local/opac
# Creating the environment
python3 -m venv .venv

# Activating the environment
source .venv/bin/activate

# Installing
pip install -U pip & pip install -r requirements.txt
```

## Configuring OPAC

- Copy the variable file default.py to local\_settings.py

```command
cd /usr/local/opac
cp opac/webapp/config/default.py  opac/webapp/config/local_settings.py
```

<table id="bkmrk-variable-de-entorno-"><tbody><tr><td style="width: 201px;">**Variable de entorno**

</td><td style="width: 375px;">**Descripción**

</td><td style="width: 233px;">**Valor predeterminado**

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_DEBUG\_MODE</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Habilita/deshabilita el modo DEBUG</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">False</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_CONFIG</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Archivo de configuración de la aplicación (consulte las instrucciones a continuación)</span>

</td><td style="width: 233px;"> </td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_COLLECTION</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Acrónimo de la colección</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">mex</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_MONGODB\_NAME</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Nombre de la base de datos MongoDB</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">opac</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_MONGODB\_HOST</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Host do MongoDB</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">localhost</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_MONGODB\_PORT</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Puerto de host MongoDB</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">27017</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_DATABASE\_DIR</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Directorio de almacenamiento base de SQLite</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">/tmp</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_DATABASE\_FILE</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Nombre de archivo SQLite</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">Opac.sqlite</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_DATABASE\_URI</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">URI da base SQLite</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">sqlite:////tmp/opac.sqlite</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_MEDIA\_ROOT</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Ruta absoluta de la carpeta que almacenará las imágenes registradas por los usuarios a través de la interfaz de administración</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">&lt;ruta&gt;/media</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_MEDIA\_URL</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">RUTA DE ACCESO DE LA URL para servir las imágenes</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">/media</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_MAIL\_SERVER</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Host del servidor de correo</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">localhost</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_MAIL\_PORT</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Puerto de host del servidor de correo</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">1025</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SECRET\_KEY</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Clave necesaria para la seguridad de los formularios de solicitud (consulte las instrucciones a continuación)</span>

</td><td style="width: 233px;"> </td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SSM\_SCHEME</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Protocolo de conexión del almacén de objetos</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">https</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SSM\_DOMAIN</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Host do Object Store</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">ssm.scielo.org</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SSM\_PORT</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Puerto de host de almacén de objetos</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">80</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SSM\_XML\_URL\_REWRITE</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">¿Cambiará el esquema de URL + autoridad registrada en el artículo? Si es true, fuerce la búsqueda del artículo en la url 'OPAC\_SSM\_SCHEME + '://' + OPAC\_SSM\_DOMAIN + ':' + OPAC\_SSM\_PORT'. De lo contrario, carga la dirección URL registrada en el artículo</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">True</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_CACHE\_ENABLED</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Activa/desactiva la cache con Redis</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">True</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_CACHE\_DEFAULT\_TIMEOUT</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Duración de los objetos de la memoria caché en segundos</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">3600</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_CACHE\_REDIS\_HOST</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Host de Redis para cache</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">cache en redis</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_USE\_METRICS</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Activa/desactiva la integración con SciELO Analytics</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">False</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_METRICS\_URL</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">URL de SciELO Analytics</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">http://analytics.scielo.org</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_USE\_DIMENSIONS</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Activa/desactiva la integración de dimensiones</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">False</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_DIMENSIONS\_METRICS\_URL</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Dirección URL de dimensiones</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">https://badge.dimensions.ai/details/doi</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_USE\_PLUMX</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Activa/desactiva la integración con PlumX</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">False</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_PLUMX\_METRICS\_URL</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">URL de PlumX</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">https://plu.mx/scielo/a</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_USE\_ALTMETRIC</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Activa/desactiva la integración altmetric</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">False</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_ALTMETRIC\_METRICS\_URL</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Dirección URL de Altmetric</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">https://www.altmetric.com/details.php</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_AUDIT\_LOG\_NOTIFICATION\_ENABLED</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Activa/desactiva las notificaciones de informes de auditoría</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">True</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_AUDIT\_LOG\_NOTIFICATION\_RECIPIENTS</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Lista de correos electrónicos que deben recibir el informe de auditoría, separados por comas (",")</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">Lista vacía (ninguna)</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SERVER\_NAME</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Nombre del servidor/IP</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">Vacío (ninguno)</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SESSION\_COOKIE\_DOMAIN</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Dominio para cookie de sesión. Configura SESSION\_COOKIE\_DOMAIN</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">Valor del OPAC\_SERVER\_NAME</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SESSION\_COOKIE\_HTTPONLY</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Habilita o deshabilita la cookie de sesión solo en HTTP. Configura SESSION\_COOKIE\_NAME</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">True</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SESSION\_COOKIE\_NAME</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Nombre de la cookie de sesión. Configura SESSION\_COOKIE\_NAME</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">opac\_session</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SESSION\_COOKIE\_PATH</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Ruta de acceso a la cookie de sesión. Configura SESSION\_COOKIE\_PATH</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">Ninguno, que es la raíz de la aplicación ("/")</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SESSION\_COOKIE\_SECURE</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Establece si la cookie de sesión debe marcarse como segura. Conjuntos SESSION\_COOKIE\_SECURE</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">False</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_SESSION\_REFRESH\_EACH\_REQUEST</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Envío de la cookie en cada solicitud. Conjuntos SESSION\_REFRESH\_EACH\_REQUEST</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">False</span>

</td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_TWITTER\_ACCESS\_TOKEN</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Token de acceso de la cuenta de twitter</span>

</td><td style="width: 233px;"> </td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_TWITTER\_ACCESS\_TOKEN\_SECRET</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Secreto de token de acceso desde la cuenta de Twitter</span>

</td><td style="width: 233px;"> </td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_TWITTER\_CONSUMER\_KEY</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Cuenta de Twitter de clave de consumidor</span>

</td><td style="width: 233px;"> </td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_TWITTER\_CONSUMER\_SECRET</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Secreto del consumidor de la cuenta de Twitter</span>

</td><td style="width: 233px;"> </td></tr><tr><td style="width: 201px;"><span style="font-weight: 400;">OPAC\_TWITTER\_SCREEN\_NAME</span>

</td><td style="width: 375px;"><span style="font-weight: 400;">Nombre de pantalla de la cuenta de Twitter</span>

</td><td style="width: 233px;"><span style="font-weight: 400;">Red SciELO</span>

</td></tr></tbody></table>