Manual de Instalacin

PRESENTACIN
La Corporacin Transparencia por Colombia, organizacin no gubernamental dedicada a la lucha contra la corrupcin en el pas, en asocio con COLNODO - Asociacin Colombiana de ONGs para la Comunicacin Va Correo Electrnico-, entregan al pas, con esta publicacin, el Manual de Instalacin, instructivo dirigido al tcnico en sistemas encargado de instalar la pgina de internet de la Alclada. El mismo hace parte de un paquete de materiales del Proyecto Internet para la Rendicin de Cuentas del Alcalde Municipal". El paquete completo contiene: (i) un CD con un software para la instalacin de una pgina de Internet para la Alcalda, y una propuesta de metodologa para la Rendicin de Cuentas del Alcalde o Alcaldesa municipal a la ciudadana; y (ii) tres manuales que acompaan el software (Manual de Instalacin, Manual del Administrador, y Manual de Autores y Editores). El proyecto Internet para la Rendicin de Cuentas del Alcalde Municipal" se realiz entre octubre del 2002 y diciembre del 2003, y cont con el apoyo financiero de USAID, a travs de Casals & Asociados. Desarroll estos materiales en asocio con las alcaldas de los municipios de Buga, Pasto, Rionegro y Popayn, con el propsito de entregar al pas, y en particular a sus municipios: (i) (ii) Un software para el montaje, administracin y alimentacin autnoma por parte de los funcionarios municipales, de una pgina web de la alcalda, que fortalezca la transparencia de la gestin municipal y que apoye la rendicin de cuentas presencial de los alcaldes/alcaldesas. Una propuesta metodolgica para la realizacin de audiencias pblicas de rendicin de cuentas del Alcalde/Alcaldesa a la ciudadana.

Para el logro de sus propsitos, el proyecto: (i) dise y mont participativamente un modelo o estndar mnimo de pgina web de la alcalda, (ii) dise una metodologa para la Rendicin de Cuentas del Alcalde/Alcaldesa, y la propuso a 4 alcaldes que participaron en el proyecto, para su prueba y ajuste (iii) desarroll un modelo de administracin de la pgina con el software Aplicaciones de Accin de APC (www.apc.org/actionapps/) para garantizar autonoma de la Alcalda en su manejo, y garantizar procedimientos sencillos para la permanente alimentacin de la misma por parte de los funcionarios y brindar con ello la oportuna informacin a la ciudadana, (iv) apoy a las alcaldas vinculadas al proyecto en la divulgacin de las pginas en medios masivos de comunicacin y en su lanzamiento, (v) desarroll el software con programas de libre circulacin para aliviar de costos a las administraciones y estimular el desarrollo tecnolgico en el pas, (vi) mont el software bajo estndares internacionales de accesibilidad para garantizar al conjunto de ciudadanos, incluidos aquellos con limitaciones visuales, el acceso a la informacin (vii) capacit a miembros de organizaciones sociales, interesadas en control social, de los cuatro municipios, en el uso del Internet y en la comprensin de la informacin publicada en las pginas, y les dio acceso gratuito a horas de Internet, para consulta por fuera de las horas de capacitacin, animando a la vigilancia de la administracin municipal, (viii) realiz una evaluacin de impacto del desarrollo de las pginas en los cuatro municipios, y (ix) anim a los municipios a introducirse en el concepto de alcaldas electrnicas o e-government. Para el diseo del modelo bsico de pgina, en cuanto a la estructura y contenidos de la base de datos que la soporta, fueron invitados a participar los secretarios de despacho, otros funcionarios que asumiran las labores de alimentar la pgina como autores y como editores, y miembros de organizaciones sociales, en especial aquellas pertenecientes al consejo municipal de planeacin de cada un de los cuatro municipios del proyecto. Para las organizaciones ejecutoras, el desarrollo del proyecto Internet para la Rendicin de Cuentas del Alcalde Municipal" fue una experiencia maravillosa de construccin y de encuentro con los funcionarios y funcionarias de las cuatro alcaldas y con los miembros de organizaciones sociales, que se involucraron. A ellos, lo mismo que a los financiadores, damos nuestros agradecimientos por la oportunidad que nos dieron de hacer realidad esta herramienta. Esperamos que el uso de las nuevas tecnologas de la informtica y las comunicaciones, a travs del paquete de materiales que hoy presentamos, contribuya al fortalecimiento del cuidado de lo pblico en el pas, al impulso de una cultura de la rendicin de cuentas de nuestros servidores pblicos, a la vigencia del principio de la transparencia de los asuntos del Estado, y a la ampliacin de la participacin ciudadana.

ROSA INES OSPINA ROBLEDO Directora Ejecutiva Corporacin Transparencia por Colombia

JULIAN CASASBUENAS Director Colnodo

CONTENIDO
1.1. Programas y equipos requeridos............................................................................................................3 1.1.1. Programas............................................................................................................................................. 3 1.1.2. Equipos.................................................................................................................................................3 1.2. Instalacin de PhpMyAdmin (opcional)....................................................................................................4 1.3. Instalacin de las Aplicaciones de Accin...............................................................................................5 1.3.1. Creacin de la base de datos de las Aplicaciones de Accin...............................................................6 1.3.1.1. Desde Lnea de comando..................................................................................................................6 1.3.1.2. Desde Phpmyadmin...........................................................................................................................7 1.3.2. Configuracin del Sistema..................................................................................................................11 1.3.3-. Creacin del usuario superadministrador de las Aplicaciones de Accin:........................................ 14 1.3.4. Cambio de clave usuario superadministrador de las Aplicaciones de Accin:...................................15

I.

Instalacin del Sistema

_____________________________

Durante el siguiente instructivo se debe tener en cuenta que la palabra municipio debe ser reemplazada por el nombre del municipio correspondiente a la instalacin en proceso

1.1. Programas y equipos requeridos.

1.1.1. Programas
El sistema funciona con las Aplicaciones de Accin de APC (http://www.apc.org/actionapps). Para la instalacin de las Aplicaciones de Accin es necesario tener instalado los siguientes paquetes1 (preferiblemente en sus ltimas versiones): Servidor Web Apache 1.3.x. Obtenga el servidor Web de Apache en http://httpd.apache.org/. El servidor web es el encargado de atender las solicitudes de los visitantes de las pginas a travs de Internet. Php 4.3.2 o superior. Obtenga Php de http://www.php.net/. Php es el lenguaje de programacin utilizado por las Aplicaciones de Accin. MySQL 4.0 o superior. MySQL es el servidor de bases de datos que se encarga de el almacenamiento de los datos del sistema.

Instale y configure cada una de estas aplicaciones en su servidor de Internet.

1.1.2. Equipos
Dadas las caractersticas del sistema se recomienda que la instalacin se realice en un servidor con alta capacidad de memoria y de almacenamiento en disco conectado a Internet. Dentro de la gama de servidores compatibles con sistema operativo Linux se encuentran las marcas Dell, IBM y Compaq (o HP). Un servidor tpico econmico puede tener las siguientes caractersticas:

Sistema Base Procesador 2.0GHz/Cach 512K/Bus Frontal 533MHz Memoria 1GB RAM Controladora Primaria Discos contectados a controladora interna SCSI Configuracin de Discos Duros Raid 5. Tres discos duros de 36GB Ultra 320, 80pin, SCSI de 1 pulgada a 10k rpm Monitor CDROM 48X Integrado Tarjeta de Red NIC Gigabit integrada Respaldo en Cinta IDE, TR40, 20/40GB, Unidad de Floppy Drive de 3.5", 1.44MB Mouse System Mouse Teclado Estndar para Windows

El precio de este equipo a precios de Diciembre de 2003 es de aproximadamente US$3.000

Todas las aplicaciones requeridas para la instalacin del sistema son de Software Libre y no requieren del pago de licenciamiento por parte de los municipios para su utilizacin. Los paquetes necesarios que fueron utilizados durante el desarrollo del proyecto se incluyen en el CDRom de la distribucin para Windows y Linux.
1

El servidor debe conectarse a Internet a travs de su tarjeta de red. Sin embargo, el sistema se puede instalar en un computador de escritorio (para pruebas), para lo cual se recomienda un computador pentium con una memoria en RAM de 128M y espacio en disco de 1 GB.

1.2. Instalacin de PhpMyAdmin (opcional)

Para facilitar la administracin de las bases de datos se recomienda realizar la instalacin de PhpMyAdmin. Phpmyadmin es una aplicacin en php que permite realizar de manera grfica la administracin de las bases de datos de MySQL a travs de un navegador. Esta herramienta permite facilitar el proceso de creacin y mantenimiento de la base de datos utilizadas por las Aplicaciones de Accin. Usted puede obtener esta herramienta en http://www.phpmyadmin.net/. La instalacin del sistema se realiza simplemente descomprimiendo el archivo phpMyAdmin que se encuentra en el directorio phpmyadmin del CD de municipios. Descomprmalo dentro de su directorio (p.e. htdocs, inetpub, wwwroot) de su servidor de Internet. Cuando realice el proceso de descompactar el archivo se genera un directorio phpMyAdmin-x.x.x.pl1, recomendamos renombrarlo a phpmyadmin para facilitar el acceso a la herramienta, de tal manera que funcionar en el URL http://municipio.gov.co/phpmyadmin/ Antes de poder utilizar la herramienta es necesario editar el archivo de configuracin config.inc.php y definir la clave de acceso del superadministrador (root) as: $cfg['Servers'][$i]['user'] $cfg['Servers'][$i]['password'] = 'root'; = 'clave asignada'; // MySQL user // MySQL password

Y definir ruta para acceso a phpmyadmin: $cfg['PmaAbsoluteUri'] = 'http://municipio.gov.co/phpmyadmin/'; Grabe los cambios y abra el URL http://municipio.gov.co/phpmyadmin/. Deber aparecer la siguiente pantalla:

Nota importante: ES UN GRAN RIESGO DE SEGURIDAD PARA EL SISTEMA DEJAR EL SERVIDOR CONECTADO A INTERNET CON PHPMYADMIN SIN RESTRICCIONES DE ACCESO A ESTA HERRAMIENTA. UTILICE LA OPCION DE RESTRINGIR EL ACCESO A UN DIRECTORIO DEL SERVIDOR WEB PARA PROTEGER ESTA HERRAMIENTA DE ACCESOS NO AUTORIZADOS.

1.3. Instalacin de las Aplicaciones de Accin

Importante: Todas las instrucciones del proceso de instalacin que se presentan a continuacin utilizan la palabra municipio, la cual debe ser reemplazada por el nombre del municipio correspondiente, especialmente cuando se refiere a direcciones de Internet. Por ejemplo, si se especifica la direccin http://www.municipio.gov.co y se est realizando la instalacin para el municipio de Pereira la direccin deber ser http://www.pereira.gov.co

En el CD de Instalacin del sistema Usted encontrar 4 archivos que contienen: apc-aa-municipio.tar.gz: Contiene los canales y estructura del sitio. Descompacte este archivo en la carpeta apc-aa-municipio de su servidor de Internet. apc-aa-files-municipio.tar.gz. Contiene los grficos del sitio. . Descompacte este archivo en la carpeta apc-aa-files-municipio de su servidor de Internet. Esta carpeta debe tener permisos de escritura para el servidor de Internet para permitir la publicacin de grficos en el sistema. aa-municipio.sql: Archivo con informacin de la base de datos SQL del sistema. municipio.tar.gz: Carpetas con las pginas estticas, hojas de estilo e imgenes asociadas al sitio. Descompacte este archivo en la carpeta municipio de su servidor de Internet.

Por ejemplo, para el municipio de Pasto una estructura de directorios de una instalacin tpica deber verse de la siguiente manera: Nivel inferior a raz servidor web pasto apc-aa-pasto apc-aa-files-pasto

1.3.1. Creacin de la base de datos de las Aplicaciones de Accin.

1.3.1.1. Desde Lnea de comando. Si Usted no est familiarizado con el montaje de bases de datos de MySQL desde la lnea de comandos le recomendamos continuar el proceso de instalacin como se describe en la siguiente seccin utilizando phpmyadmin. Desde lnea de comandos ejecute: mysqladmin -u root -p create aa-municipio Enter password: Para crear la base de datos aa-municipio. Usted deber conocer y dar la clave de administrador (root) del servidor MySQL. Para cargar los datos a la base de datos ejecute: mysql -u root -p aa-municipio < aa-municipio.sql Enter password: mysql u root p mysql Enter password: Cree el usuario que acceder la base de datos de las Aplicaciones de Accin: insert into user (Host,User,Password) values ('localhost','nombre-usuario',password('clave-usuario')); Asigne los permisos a la base de datos de las Aplicaciones de Accin al usuario recien creado: insert into db (Host,Db,User,Select_priv,Insert_priv,Update_priv,Delete_priv,Create_priv,Drop_priv, Index_priv,Alter_priv) values ('localhost','aa-municipio','nombre-usuario','Y','Y','Y','Y','Y','Y','Y','Y'); Active los cambios: flush privileges; Tenga en cuenta que los parmetros de las tablas de las bases de datos pueden variar entre versiones de MySQL y es posible que los comandos ac mostrados no funcionen para ciertas versiones de MySQL.

1.3.1.2. Desde Phpmyadmin. Desde phpmyadmin cree una nueva base de datos aa-municipio para las AA.

El sistema debe responder: Base de Datos aa-municipio se ha creado. En la base de datos mysql cree un usuario administrador de la base de datos para las Aplicaciones de Accin: Seleccione la base de datos Mysql

y posteriormente la tabla user:

Seleccione la opcin Insertar nueva fila. Cree un usuario para la base de datos asignando las siguientes variables: Host: localhost Usuario: admin Password: (clave asignada por Usted) Importante: Tenga presente que en el campo password debe asignar la funcin password. Este ser el nombre de usuario y clave que Usted deber utilizar en la configuracin de las Aplicaciones de Accin como se explicar ms adelante. Deje todos los permisos del usuario en NO.

Seleccione el botn Continue para grabar los cambios. La nueva entrada deber reflejarse en la lista de usuarios de la Base de Datos de Mysql:

Posteriormente se deben asignar los permisos a la base de datos al usuario recin creado as: Seleccione la tabla DB de MySql y a continuacin la opcin Insertar nueva fila:

Defina los campos as: Host: localhost Db: aa-municipio User: admin

Y asgnele todos los permisos a este usuario (seleccionando en todos los permisos YES):

Posteriormente ejecute SQL en la Base de Datos aa-municipio creando todas las tablas de las AA. Para esto, seleccione examinar utilizando la ejecucin de secuencias de SQL en la Base de Datos aa-municipio que se encuentra en el archivo aa-municipio.sql:

Despus de seleccionar el archivo aa-municipio.sql presione el botn Contine. El sistema deber responder:

10

Su consulta ha sido ejecutada con xito De esta forma la base de datos ha sido creada. Si Este procedimiento presenta errores durante su ejecucin le recomendamos actualizar la base de datos manualmente utilizando el comando: mysql -u root -p aa-municipio < aa-municipio.sql Reinicie MySQL.

1.3.2. Configuracin del Sistema

Descomprima en su directorio (p.e. htdocs, inetpub, wwwroot) del servidor de Internet el archivo apc-aamunicipio.tar.gz, apc-aa-files-municipio.tar.gz y municipio.tar.gz. Vea la seccin 1.3 con recomendaciones de la estructura de directorios para la instalacin. Edite el archivo de configuracin de apache httpd.conf y agregue los siguientes datos:

Para windows (reemplace las negrillas por los valores correspondientes a su instalacin)

<VirtualHost direccin IP del servidor> ServerName www.municipio.gov.co ServerAlias municipio.gov.co DocumentRoot c:/apache/htdocs/municipio ErrorLog logs/municipio.error.log CustomLog logs/municipio.access.log common Alias /apc-aa c:/apache/htdocs/apc-aa-municipio Alias /apc-aa-files c:/apache/htdocs/apc-aa-files-municipio <Directory c:/apache/htdocs/apc-aa-municipio/admin> DirectoryIndex index.php3 </Directory> <Directory c:/apache/htdocs/municipio> Options Includes FollowSymLinks DirectoryIndex index.shtml sitio.shtml index.php index.html index.htm </Directory> </VirtualHost>

11

Para linux

<VirtualHost direccin IP del servidor> ServerName www.municipio.gov.co ServerAlias municipio.gov.co DocumentRoot /var/www/municipio ErrorLog /var/log/apache/municipio.error.log CustomLog /var/log/apache/municipio.access.log common Alias /apc-aa /var/www/apc-aa-municipio Alias /apc-aa-files /var/www/apc-aa-files-municipio <Directory /var/www/apc-aa-municipio/admin> DirectoryIndex index.php3 </Directory> <Directory /var/www/municipio> Options Includes FollowSymLinks DirectoryIndex index.shtml sitio.shtml index.php index.html index.htm </Directory> </VirtualHost> Reinicie el servidor Web. Posteriormente edite el archivo de configuracin de las Aplicaciones de Accin config.php3 que se encuentra en el directorio /apc-aa-municipio/include, y configure los siguientes parmetros: AA_BASE_PATH. Defina el directorio de las Aplicaciones de Accin. Debe colocarse una ruta absoluta. $AA_BASE_PATH = "/var/www/apc-aa-municipio/"; Coloque la ruta correspondiente de acuerdo con su instalacin. AA_INSTAL_URL. Este parmetro define el URL en donde quedan instaladas las Aplicaciones de Accin: DEFAULT_ORG_ID. Define el dominio en donde se encuentran las AA. Configuracin de los parmetros de la base de datos:

define("AA_INSTAL_URL", "http://www.municipio.gov.co/apc-aa/"); define("DEFAULT_ORG_ID", "municipio.gov.co"); DB_HOST. Nombre del host en donde se alojar la base de datos. define("DB_HOST", "localhost"); DB_NAME. Nombre de la base de datos de las Aplicaciones de Accin. define("DB_NAME", "aa-municipio"); DB_USER. Nombre del usuario que accede la base de datos. define("DB_USER", "admin"); DB_PASSWORD. Clave del usuario que accede la base de datos. define("DB_PASSWORD", "password");

ORG_NAME. Nombre del municipio.

define("ORG_NAME","Municipio");

12

AA_ID. Idenficador hexadecimal nico de las Aplicaciones de Accin. Si Usted va a intercambiar contenido entre sitios debe cambiar este parmetro. En cualquier caso se recomienda cambiarlo. Debe ser exactamente de 32 caracteres y debe contener nmeros y letras de la A hasta la F inclusive. Este identificador puede obtenerse desde Linux con el comando:

head /dev/urandom | md5sum define("AA_ID", " e25e3c7f22866b03698bcb38a8137adb"); PERM_LIB. Sistema de permisos utilizado. Debe ser SQL: ERROR_REPORTING_EMAIL. Direccin de correo electrnico a quien se envan reportes de error de las Aplicaciones de Accin: DEFAULT_LANG_INCLUDE. Idioma por defecto. Para espaol utilice es_news_lang.php3 Parmetros de imgenes.

define("PERM_LIB", "sql");

define("ERROR_REPORTING_EMAIL", "usuario@municipio.gov.co"); define("DEFAULT_LANG_INCLUDE", "es_news_lang.php3"); IMG_UPLOAD_MAX_SIZE. Define el tamao mximo de imgenes que aceptar el sistema. define("IMG_UPLOAD_MAX_SIZE", "400000"); IMG_UPLOAD_URL. Directorio en donde se copian las imgenes que utilizarn las Aplicaciones de Accin. Ntese que el directorio indicado aqu (apc-aa-files-municipio en el ejemplo) debe existir bajo el directorio (p.e. htdocs, inetpub, wwwroot) en el servidor de Internet. Igualmente se deben asignar permisos de escritura para el usuario que ejecuta el servidor Apache. define("IMG_UPLOAD_URL", "/apc-aa-files-municipio/"); IMG_UPLOAD_PATH. Ruta absoluta del directorio de imgenes: define("IMG_UPLOAD_PATH", "/var/www/apc-aa-files-municipio/");

Posteriormente edite el archivo site_municipios.php3 que se encuentra en el directorio /apc-aamunicipio/modules/site/sites y defina el nombre del municipio que aparecer en el encabezado del sitio en el siguiente parmetro: 'municipio' => 'municipio' => 'Municipio' 'Pereira'

Por ejemplo, si su municipio es Pereira la lnea deber quedar:

13

1.3.3. Creacin del usuario superadministrador de las Aplicaciones de Accin: Acceda a la direccin: http://www.municipio.gov.co/apc-aa/admin/setup.php3 Este vnculo solo funcionar una vez.

Recomendamos eliminar el archivo setup.php3 para evitar accesos indebidos a la configuracin del sistema. Seleccione el botn Instalar y digite la informacin requerida para la cuenta de super administrador de las Aplicaciones de Accin:

Con lo que el sistema contestar:

14

1.3.4. Cambio de clave usuario superadministrador de las Aplicaciones de Accin:

Una vez concluido el proceso de instalacin Usted podr ingresar al sistema a travs del URL: http://www.municipio.gov.co/apc-aa/admin/ y deber acceder a la pantalla de validacin de usuarios del sistema:

Entre como usuario superadministrador del sistema con nombre de usuario y contrasea recin creada Para asignar una nueva clave al superadministrador del sistema ingrese a la opcin AA y posteriormente Editar Usuario:

15

A continuacin diligencie el formulario para la cuenta del superadministrador del sistema:

Defina una nueva clave y verifquela. Cercirese que la opcin Cuenta de superadministrador est activada. Importante: La seguridad de su sistema depender de la clave que Usted asigne a la cuenta del superadministrador. En lo posible tenga en cuenta:

Una buena clave rene combinacin de maysculas, minsculas, nmeros y smbolos. Adems, es aconsejable que los nmeros y/o smbolos aparezcan en medio de la clave, y no al principio o final. Se recomienda que la nueva clave tenga por lo menos 6 caracteres, y que cumpla unos mnimos requisitos de seguridad La clave debe conocerla solamente el administrador del sistema. Cambie la clave al menos una vez al mes. Nunca utilice el nombre de usuario como clave. Nunca utilice su nombre ni letras de su nombre o de su municipio en su clave. No utilice una palabra o nombre como clave (p.e. Cartagena, salud, vivienda, etc). Una buena clave puede basarse en una frase fcil de recordar, por ejemplo: "La vaca que rie va melgar - 9" corresponde a la clave LvqrvM-9. *NO utilice este ejemplo como clave* La clave debe tener mnimo: 6 caracteres Debe ser distinta de la actual (admin). Debe contener letras y nmeros. Puede contener caracteres como $ ! % - _ /. ; ,

16

Diligencie el formulario y teclee el botn Actualizar al final de la pgina para guardar los cambios. Entre al sistema y edite el canal Sitio Municipio y la opcin Module Settings para determinar el identificador de su sitio y configurar el sistema de acuerdo con su dominio:

Verifique que el identificador del canal corresponda al que se encuentra en el archivo sitio.shtml de su sitio: <!--#include virtual="/apc-aa/modules/site/site.php3?site_id=6a36dd0e6b9cad4af934392f56fbc80b"--> Ntese que el Id corresponde al que se muestra en la pantalla del Administrador de sitios. Cercirese que el URL corresponda a su dominio: http://municipio.gov.co/sitio.shtml Finalmente cercirese de tener un vnculo en el directorio de Internet del sistema desde index.shtml al archivo sitio.shtml, o bien copie sitio.shtml a un archivo con nombre index.shtml: lrwxrwxrwx 1 www-data webmaste 11 Sep 19 14:59 index.shtml -> sitio.shtml

Refirase al captulo 5 de este manual para efectuar la administracin de su sistema. En este nivel Usted ya deber poder acceder al sitio del municipio a travs de la direccin http://www.municipio.gov.co/ (o http.//localhost/ si no se ha registrado aun el dominio de su municipio).

17