Manual de Instalación del Sistema de Gestión Documental Quipux Junio de 2010 1.- Introducción He tratado de hacer un manual lo más sencillo y lo más estándar posible, funciona igual en distribuciones como Debian, Centos, Ubuntu y en teoría cualquier GNU Linux, nosotros lo tenemos funcionando al 100% en Ubuntu (por lo tanto funciona en Debian) en las máquinas de desarrollo y en Centos 5.2 en los servidores de producción. Ah y por cierto, el sistema Quipux NO FUNCIONA CON SERVIDORES WINDOWS, lo lamento... El manual lo desarrollé basado en Ubuntu, porque es el sistema operativo que actualmente estoy utilizando, la instalación es la misma sin importar su distribución, claro, teniendo en cuenta que la paquetería se instala diferente en cada sistema; por ejemplo para instalar apache en Debian o Ubuntu ejecutamos aptitude install apache2 mientras en Centos yum install httpd y algunos archivos están ubicados en sitios diferentes. En este manual no voy a enseñarles como instalar los diferentes paquetes, en internet ustedes pueden encontrar suficiente información para instalarlos. La configuración que veremos es muy básica y les ayudará a instalar y configurar una máquina de pruebas, para configurar un servidor real es básicamente lo mismo, pero ustedes deberán encargarse de poner todas las seguridades necesarias para que no estén expuestos a ataques, deberán modificar las contraseñas y publicar los nombres de sus servidores. Nota: Dependiendo de sus necesidades y de los recursos con que cuenten, pueden instalar todo el sistema en un solo equipo o en varios servidores, en un ambiente real les sugiero contar con tres equipos: uno para servidor web, uno para generar PDFs y uno para la base de datos (este debe ser bastante robusto dependiendo de la carga que manejen, los otros no consumen muchos recursos). Y antes de comenzar con la instalación, algo de propaganda... El sistema Quipux es un sistema de Gestión Documental que está siendo utilizado por el Gobierno Ecuatoriano, hasta el momento que elaboré este manual, tenía registrados cerca de 25.000 funcionarios públicos y 65.000 ciudadanos; se han creado en el sistema algo más de 2 millones de documentos; se conectan diariamente cerca de 7000 usuarios, los que generan al rededor de 20.000 documentos por día entre originales y copias. Es posible que el sistema no cumpla con todas sus expectativas, pero es un sistema que funciona, está desarrollado completamente con software libre y liberado con licencia AGPL, por lo que si hay algo que no les gusta, ustedes mismos pueden hacer los cambios que requieran. Por otro lado fue desarrollado y está siendo mantenido por el Estado Ecuatoriano, por lo que el sistema es actualizado todo el tiempo y periódicamente se liberan nuevas actualizaciones para la comunidad. Ahora si, manos a la obra.
2.- Instalación del Sistema Quipux. Vamos a dividir nuestra instalación como si lo hiciéramos en 3 equipos diferentes: Sevidor Web Servidor de Base de Datos Servidor para generar PDFs Todo esto se puede configurar en un solo equipo, como les decía depende de la infraestructura que le vayan a asignar al sistema. Nota: Por el momento no instalaremos el módulo de firma digital, apenas pueda actualizo este manual con la información de ese módulo. 2.1.- Instalación del servidor WEB 1.Instalamos el sistema operativo 2.Instalamos los siguientes paquetes: Apache2 php-pear php5 php5-gd php5-pgsql php-soap subversion sendmail 1.Editamos el archivo php.ini (/etc/php5/apache2/php.ini en Ubuntu) y modificamos los siguientes valores de las variables de configuración. register_globals = On display_errors = On #(únicamente mientras configuran el sistema, luego les sugiero regresarla a Off ). short_open_tag = On register_long_arrays = On memory_limit = 32 #Mínimo 32, se sugiere 64 o 128 1.Reiniciamos el servidor apache: /etc/init.d/apache2 restart Para comprobar que Apache está ejecutándose y acepta scripts PHP, hacemos lo siguiente: En /var/www cree un archivo llamado phpinfo.php, el cual debe contener las siguientes instrucciones: <?php?> phpinfo(); Abra su navegador Web y en la dirección URL coloque: http://ip_servidor/phpinfo.php esto deberá mostrarle una página con información de la configuración de PHP.
Si todo va bien hasta aquí, borramos el archivo creado. 1.En nuestro webroot (/var/www en Ubuntu) creamos una carpeta llamada quipux mkdir /var/www/quipux 1.Utilizando Subversión, descargamos la última versión del sistema Quipux en la carpeta que acabamos de crear con el siguiente comando: svn checkout http://svn.quipux.org/quipux /var/www/quipux 1.Creamos el archivo de configuración del sistema Quipux: cp /var/www/quipux/config2.php /var/www/quipux/config.php 1.Creamos el repositorio de archivos: mkdir /var/www/quipux/bodega mkdir /var/www/quipux/bodega/logos mkdir /var/www/quipux/bodega/plantillas mkdir /var/www/quipux/bodega/tmp mkdir /var/www/quipux/bodega/2010 (o el año actual) 1.Editamos el archivo /var/www/quipux/config.php y completamos la siguiente información en base a nuestros parámetros: //Email del Super Administrador del Sistema QUIPUX $amd_email = "administrador@dominio.com"; // email de la cuenta de soporte $cuenta_mail_soporte = "soporte@dominio.com"; // email de la cuenta desde la que se enviarán los recordatorios a los usuarios $cuenta_mail_envio = "recordatorio@dominio.com";
// Nombre de nuestro servidor; por ejemplo: http://quipux.dominio.com // o http://127.0.0.1/quipux o http://192.168.0.5/quipux $nombre_servidor="http://nombre_servidor_quipux"; 2.Cambiamos los permisos y el propietario de las carpetas y archivos: chown -R apache:apache /var/www/quipux cd /var/www/quipux find. -type d -exec chmod 755 {} \; find. -type f -exec chmod 644 {} \; Por seguridad sugerimos dar permisos 755 a todos los directorios y 644 a todos los archivos. 1.Por último accedemos a la aplicación desde nuestro navegador (http://ip_servidor/phpinfo.php), debe mostrarse esta pantalla: 2.2.- Instalación del servidor de Base de Datos 1.Instalamos el sistema operativo 2.Instalamos el servidor de base de Datos Postgresql 8.2. Lamentablemente el sistema no funciona con versiones superiores aunque estamos trabajando para corregir esto. 3.Modificamos los archivos de configuración de postgres.ingresamos al directorio /etc/postgresql/8.2/main y configuramos los archivos postgresql.conf y pg_hba.conf Editamos el archivo /etc/postgresql/8.2/main/postgresql.conf: Cambiamos la línea: listen_addresses = '*' A continuación editamos el archivo /etc/postgresql/8.2/main/pg_hba.conf y aumentamos el Número IP de la máquina
# IPv4 local connections: host all all 127.0.0.1/32 md5 host all all 192.168.0.22/32 md5 (suponiendo que el IP de la máquina sea 192.168.0.22) Por seguridad se recomienda poner únicamente el número IP del servidor web pero si se desea que cualquier usuario de la red tenga acceso al servidor de base de datos se puede incluir la siguiente línea: host all all 192.168.0.0/24 md5 (suponiendo que el número de la subred sea 192.168.0.0) 4.Reiniciamos el servidor de base de datos PostgreSQL sudo /etc/init.d/postgresql-8.2 restart 5.Cambiamos la clave del usuario postgres sudo passwd postgres 6.Nos cambiamos de usuario al usuario postgres su postgres 7.Ingresamos al servidor de base de datos PostgreSQL con el comando psql 8.Cambiamos la contraseña del usuario postgres de la base de datos y salimos de psql ALTER USER postgres WITH PASSWORD 'nuevo_password'; \q 9.Para mayor facilidad en la administración de la base de datos vamos a utilizar el paquete pgadmin III, lo podemos instalar en otra máquina y con este nos conectamos a nuestro servidor de base de datos. 10.Una vez instalado, creamos una nueva conexión al servidor de BDD (hacemos chlick sobre el ícono ) y nos aparecerá el siguiente wizard que nos ayudará a configurar la conexión.
11.A continuación creamos una nueva base de datos con los siguientes parámetros: name: quipux owner: postgres encoding: UTF-8 Tablespace: pg_default 12.Para mayor facilidad en la administración de la base de datos vamos a utilizar el paquete pgadmin III, lo podemos instalar en otra máquina y con este nos conectamos a nuestro servidor de base de datos. 13.Abrimos el editor SQL y ejecutamos los scripts para la creación de tablas y los inserts básicos para que funcione el sistema (los scripts se encuentran en el directorio /var/www/quipux/bdd). 14.Caso contrario podemos restaurar desde el backup que se encuentra en el mismo directorio. Para esto damos un click derecho sobre la base de datos y seleccionamos la opción Restaurar y nos aparecerá un wizard que nos ayudará a restaurar la base de datos:
Únicamente marcamos la opción No owner y verificamos que no existan errores en el proceso. 15.Luego configuramos la conexión del sistema Quipux con la base de datos: Editamos el archivo /var/www/quipux/config.php (en el servidor Quipux) y cambiamos las siguientes variables: $usuario = "Usuario de la base de datos"; $contrasena = "Contraseña de la base de datos"; $servidor = Servidor de BDD:puerto ; //ejm: "192.168.0.22:5432"; $db = "nombre de la BDD"; 16.Por último ingresamos a la aplicación. 17.En el campo cédula ponemos ADMINISTRADOR y la contraseña es 123 e ingresamos al sistema.
Nota: Si tienes algún problema para ingresar y no se te muestra esta pantalla, te sugiero ejecutar el archivo test_config.php, este archivo verifica que varios de los puntos de la configuración estén correctos y te da sugerencias para solucionar los inconvenientes. Ingresa desde desde tu navegador Web http://ip_servidor/quipux/test_config.php 2.3.- Instalación del servidor de PDFs 1.Instalamos el sistema operativo 2.Instalamos los siguientes paquetes: Apache2 php-pear php5 php5-gd php-soap subversion ghostscript html2ps 1.En nuestro webroot (/var/www en Ubuntu) creamos una carpeta llamada html_a_pdf mkdir /var/www/html_a_pdf 1.Utilizando Subversión, descargamos la última versión del módulo para generación de PDFs en la carpeta que acabamos de crear con el siguiente comando:
svn checkout http://svn.quipux.org/html_a_pdf /var/www/html_a_pdf 1.Creamos los archivos de configuración: cp /var/www/html_a_pdf/config2.php /var/www/html_a_pdf/config.php cp /var/www/html_a_pdf/html_a_pdf2.wsdl /var/www/html_a_pdf/ html_a_pdf.wsdl 1.Modificamos el archivo config.php en base a los datos de nuestro servidor: $nombre_servidor = 'http://ip_servidor/html_a_pdf' Nota: no es necesario que este servidor esté publicado, basta con que el servidor Quipux pueda acceder a el. 2.Editamos el archivo html_a_pdf.wsdl y al final del archivo cambiamos la variable soap: address location: <soap:address location="http://ip_servidor/html_a_pdf/html_a_pdf.php"/> Este archivo es fundamental para la comunicación entre el servidor Quipux y el Servidor de PDFs. Para probar la conexión ingresamos desde nuestro navegador web la siguiente dirección y debe mostrarse la siguiente pantalla: http://ip_servidor/html_a_pdf/html_a_pdf.php?wsdl
3.Por último le indicamos a nuestro servidor Quipux la dirección de nuestro servidor de PDFs: Editamos el archivo /var/www/quipux/config.php (en el servidor Quipux) y cambiamos la siguiente variable: $servidor_pdf = 'http://ip_servidor/html_a_pdf';
Nota 1: Las plantillas son archivos PDF de tamaño A4 en las que tienes un margen de 4cm en la parte superior para el encabezado y 3cm en la parte inferior para el pié de página. Puedes poner imágenes o lo que tú desees. Nota 2: Hay veces que las plantillas no funcionan, es por el programa en que las generas, puedes utilizar Open Office o descargarte gratis programas como el pdf creator o el pdf995 (recomendado). NO FUNCIONAN LAS PLANTILLAS GENERADAS CON MICROSOFT OFFICE 2007. Nota 3: La instalación del módulo de firma digital les quedo debiendo. Nota 4: Por último, cuando configuren sus instituciones, creen una nueva institución, NO utilicen la institución creada por defecto. Espero que les sirva y cualquier duda, estoy a las órdenes. Mauricio Haro A.