Manual de Instalacin del

Sistema de Gestin Documental Quipux

Junio de 2010

1.- Introduccin
He tratado de hacer un manual lo ms sencillo y lo ms estndar posible, funciona igual en
distribuciones como Debian, Centos, Ubuntu y en teora cualquier GNU Linux, nosotros lo
tenemos funcionando al 100% en Ubuntu (por lo tanto funciona en Debian) en las mquinas de
desarrollo y en Centos 5.2 en los servidores de produccin. 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 instalacin es la misma sin importar su distribucin, claro, teniendo en
cuenta que la paquetera 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 estn ubicados en sitios diferentes.
En este manual no voy a ensearles como instalar los diferentes paquetes, en internet ustedes
pueden encontrar suficiente informacin para instalarlos.
La configuracin que veremos es muy bsica y les ayudar a instalar y configurar una mquina
de pruebas, para configurar un servidor real es bsicamente lo mismo, pero ustedes debern
encargarse de poner todas las seguridades necesarias para que no estn expuestos a ataques,
debern modificar las contraseas 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 instalacin, algo de propaganda...
El sistema Quipux es un sistema de Gestin Documental que est siendo utilizado por el
Gobierno Ecuatoriano, hasta el momento que elabor este manual, tena registrados cerca de
25.000 funcionarios pblicos y 65.000 ciudadanos; se han creado en el sistema algo ms de 2
millones de documentos; se conectan diariamente cerca de 7000 usuarios, los que generan al
rededor de 20.000 documentos por da 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 peridicamente se liberan nuevas actualizaciones para
la comunidad.
Ahora si, manos a la obra.

2.- Instalacin del Sistema Quipux.

Vamos a dividir nuestra instalacin como si lo hiciramos 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 deca depende de la infraestructura
que le vayan a asignar al sistema.
Nota: Por el momento no instalaremos el mdulo de firma digital, apenas pueda actualizo este
manual con la informacin de ese mdulo.

2.1.- Instalacin del servidor WEB

1. Instalamos el sistema operativo
2. Instalamos los siguientes paquetes:

Apache2
php5
php5-gd
php5-pgsql
php-soap
subversion
sendmail

3. Editamos el archivo php.ini (/etc/php5/apache2/php.ini en Ubuntu) y modificamos los

siguientes valores de las variables de configuracin.

register_globals = Off
register_long_arrays = Off
display_errors = On #(nicamente mientras configuran el sistema, luego les
sugiero regresarla a Off).
short_open_tag = On
memory_limit = 32 #Mnimo 32, se sugiere 64 o 128

4. Reiniciamos el servidor apache:

/etc/init.d/apache2 restart

Para comprobar que Apache est ejecutndose 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 direccin URL coloque:
http://IP_SERVIDOR/phpinfo.php
esto deber mostrarle una pgina con informacin de la configuracin de PHP.

Si todo va bien hasta aqu, borramos el archivo creado.

5. En nuestro webroot (/var/www en Ubuntu) creamos una carpeta llamada quipux

mkdir /var/www/quipux

6. Utilizando Subversin, descargamos la ltima versin del sistema Quipux en la carpeta

que acabamos de crear con el siguiente comando:

svn checkout http://svn.quipux.org/quipux /var/www/quipux

7. Creamos el archivo de configuracin del sistema Quipux:

cp /var/www/quipux/config2.php /var/www/quipux/config.php

8. Creamos el repositorio de archivos:

mkdir
mkdir
mkdir
mkdir
mkdir

/var/www/quipux/bodega
/var/www/quipux/bodega/logos
/var/www/quipux/bodega/plantillas
/var/www/quipux/bodega/tmp
/var/www/quipux/bodega/2012 (o el ao actual)

9. Editamos el archivo /var/www/quipux/config.php

informacin en base a nuestros parmetros:

completamos

la

siguiente

//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 enviarn 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";
10. 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.
11. Por
ltimo
accedemos
a
la
aplicacin
desde
(http://IP_SERVIDOR/quipux), debe mostrarse esta pantalla:

nuestro

navegador

2.2.- Instalacin del servidor de Base de Datos

1. Instalamos el sistema operativo
2. Instalamos el servidor de base de Datos Postgresql, se sugiere la versin 9.1 pero el
sistema funciona correctamente con versiones anteriores.
3. Modificamos los archivos de configuracin de postgres.Ingresamos al directorio
/etc/postgresql/9.x/main y configuramos los archivos postgresql.conf y pg_hba.conf
Editamos el archivo /etc/postgresql/9.x/main/postgresql.conf:
Cambiamos la lnea:
listen_addresses = '*'
A

continuacin

editamos

el

archivo

/etc/postgresql/8.2/main/pg_hba.conf

aumentamos el Nmero IP de la mquina

# 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 mquina sea 192.168.0.22)
Por seguridad se recomienda poner nicamente el nmero 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 lnea:
host all
all
192.168.0.0/24
md5
(suponiendo que el nmero de la subred sea 192.168.0.0)

4. Reiniciamos el servidor de base de datos PostgreSQL

sudo /etc/init.d/postgresql-9.x 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 contrasea 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 administracin de la base de datos vamos a utilizar el
paquete pgAdmin III, lo podemos instalar en otra mquina y con este nos conectamos
a nuestro servidor de base de datos.

10. Una vez instalado, creamos una nueva conexin al servidor de BDD (hacemos chlick
sobre el cono
conexin.

) y nos aparecer el siguiente wizard que nos ayudar a configurar la

11. A continuacin creamos una nueva base de datos con los siguientes parmetros:
name: quipux
owner: postgres
encoding: UTF-8
Tablespace: pg_default

12. Abrimos el editor SQL

y ejecutamos los scripts para la creacin de tablas y los

inserts bsicos para que funcione el sistema (los scripts se encuentran en el
directorio /var/www/quipux/bdd).

13. 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
opcin Restaurar y nos aparecer un wizard que nos ayudar a restaurar la base de
datos:

nicamente marcamos la opcin No owner y verificamos que no existan errores en

el proceso.
14. Luego configuramos la conexin del sistema Quipux con la base de datos:
Editamos el archivo /var/www/quipux/config.php
cambiamos las siguientes variables:

(en

el

servidor

Quipux)

$usuario = "Usuario de la base de datos";

$contrasena = "Contrasea de la base de datos";
$servidor = Servidor de BDD:puerto; //ejm: "192.168.0.22:5432";
$db = "nombre de la BDD";
15. Por ltimo ingresamos a la aplicacin.

16. En el campo cdula ponemos ADMINISTRADOR y la contrasea es 123 e ingresamos

al sistema.

Nota: Si tienes algn 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
configuracin estn correctos y te da sugerencias para solucionar los inconvenientes.
Ingresa desde desde tu navegador Web http://IP_SERVIDOR/quipux/test_config.php

2.3.- Instalacin 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

3. En nuestro webroot (/var/www en Ubuntu) creamos una carpeta llamada html_a_pdf

mkdir /var/www/html_a_pdf

4. Utilizando Subversin, descargamos la ltima versin del mdulo para generacin 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

5. Creamos los archivos de configuracin:

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

6. 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.
7. 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 comunicacin entre el servidor Quipux y el Servidor de
PDFs.
Para probar la conexin ingresamos desde nuestro navegador web la siguiente direccin y debe
mostrarse la siguiente pantalla:
http://IP_SERVIDOR/html_a_pdf/html_a_pdf.php?wsdl

8. Por ltimo le indicamos a nuestro servidor Quipux la direccin de nuestro servidor de

PDFs:
Editamos el archivo /var/www/quipux/config.php
cambiamos la siguiente variable:
$servidor_pdf = 'http://IP_SERVIDOR/html_a_pdf';

(en

el

servidor

Quipux)

Nota 1: Las plantillas son archivos PDF de tamao 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 pgina. Puedes
poner imgenes 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 instalacin del mdulo de firma digital les quedo debiendo.
Nota 4: Por ltimo, cuando configuren sus instituciones, creen una nueva institucin, NO
utilicen la institucin creada por defecto.
Espero que este manual les haya sido de utilidad.
Saludos cordiales.
Mauricio Haro Acosta