Instalación Consigna

Requisitos

Sistema operativo Linux (probado con Red Hat 7, 9, Enterprise 3, 4, 5, 6 y 7). Debería ser sencillo utilizar otro sistema UNIX pero no se ha probado.
Servidor web (probado con Apache)
PHP (soporte para db4 instalado --with-db4)
Para el caso de Red Hat Linux Enterprise 6 necesitaríamos disponer de estos paquetes RPM:
- httpd
- php
- php-dba
- php-ldap (para la validación contra LDAP)

Instalación

1. Configuración de PHP

En la configuración de PHP (php.ini, la ubicación de este fichero depende de cada instalación, pero por ejemplo para Red Hat Linux Enterprise 4 ésta es: /etc/php.ini) modificamos los siguientes parámetros:

file_uploads = On
post_max_size = 100M (lo establecemos al tamaño máximo de fichero deseado, p.e. 100 MB)
upload_max_filesize = 100M (lo establecemos al tamaño máximo de fichero deseado, p.e. 100 MB)

2. Instalación del software

Descomprimimos el fichero consigna.zip (25/02/2022)

Movemos el directorio html a la carpeta web que consideremos oportuna (p.e. /var/www/html) y editamos los siguientes ficheros:

.config/conf.php => este es el fichero de configuración de la aplicación. Los parámetros más importantes a modificar son:
- $GLOBALS["availablelanguages"] = array( "eu" => "eu-ES", "es" => "es-ES", "en" => "en-US" ); => Lenguajes disponibles
- $GLOBALS["language"] = "es"; => Lenguaje por defecto
- $GLOBALS["urlssl"] = "https://%URLCONSIGNA%/index.php"; => URL de acceso a consigna a través de SSL (utilizada cuando nos validamos contra LDAP).
- $GLOBALS["subredes"] = array ('', ...); => Array donde se indicarán las subredes locales y a las que no se les aplica la regla anti relay.
- $GLOBALS["home_dir"] = "/var/zaindegi/files"; => Directorio donde se almacenarán los ficheros guardados en consigna.
- $GLOBALS["quota"] = 2147483648; // 2 GB => Tamaño máximo en bytes destinado para los ficheros a almacenar.
- $GLOBALS["maxfilesize"] = 100; => Tamaño máximo en MB autorizado del fichero a subir (se usa en un mensaje informativo, no sirve para controlar el tamaño de los ficheros subidos).
- $GLOBALS["dbfile"] = "/var/zaindegi/db/zaindegi.db"; => Fichero DB usado por la aplicación.
- $GLOBALS["logfile"] = "/var/zaindegi/logs/zaindegi.log"; => Fichero de log
- $GLOBALS["antivirus"] = ""; => Si queremos que los ficheros se escaneen por un antivirus antes de ser depósitos en consigna, introduciremos el comando de escaneo aquí. Si se deja vacio, los ficheros no se escanean.
- $GLOBALS["usarldap"] = true; => Permitir utilizar LDAP para validarse. A los usuarios validados no se les aplica la regla anti-relay.
- $GLOBALS["hostldap"] = "ldaps://ldap.ehu.es"; => Servidor o servidores LDAP usados para la validación.
- $GLOBALS["dias"] = 3; => Número de días a mantener los ficheros en consigna antes de que sean borrados por el garbage collector.
.include/header.php => modificamos la función show_header para que la cabecera de las páginas tenga el aspecto que deseemos.
.include/footer.php = > modificamos la función show_footer para que el pie de las páginas tenga el aspecto que deseemos.
El usuario del servidor web ha de tener permisos de escritura sobre las carpetas db, files y logs.

3. Borrado automático de ficheros antiguos

El sistema de consigna integra un mecanismo simple para borrar periódicamente los ficheros que llevan más de un determinado tiempo en la consigna. Este se hace mediante un script de php que se ejecuta en el cron. Este script se llama garbage-collector.php y lo añadiremos al cron para que se ejecute las veces que nos interese (por lo menos una vez al día). Lo haremos con una línea similar a la siguiente:

05 0 * * * /var/zaindegi/scripts/garbage-collector.php > /dev/null 2>&1

Dentro del directorio scripts de la aplicación existen un par de script en PHP para labores de administración:

deletefile.php => este script permite borrar un fichero subido a consigna y que sea considerado como inadecuado.
dumpdb.php => este script hace un volcado de la BD interna de consigna por motivos de depuración.

Fecha de la última modificación: 25/02/2022