��������������������

PRESENTACIÓN

La Corporación Transparencia por Colombia, organización no gubernamental dedicada a la lucha contra la corrupciónen el país, en asocio con COLNODO - Asociación Colombiana de ONGs para la Comunicación Vía Correo Electrónico-,entregan al país, con esta publicación, el Manual de Instalación, instructivo dirigido al técnico en sistemas encargadode instalar la página de internet de la Alcladía. El mismo hace parte de un paquete de materiales del Proyecto “Internetpara la Rendición de Cuentas del Alcalde Municipal".

El paquete completo contiene: (i) un CD con un software para la instalación de una página de Internet para la Alcaldía,y una propuesta de metodología para la Rendición de Cuentas del Alcalde o Alcaldesa municipal a la ciudadanía; y (ii)tres manuales que acompañan el software (Manual de Instalación, Manual del Administrador, y Manual de Autores yEditores).

El proyecto “Internet para la Rendición de Cuentas del Alcalde Municipal" se realizó entre octubre del 2002 ydiciembre del 2003, y contó con el apoyo financiero de USAID, a través de Casals & Asociados. Desarrolló estosmateriales en asocio con las alcaldías de los municipios de Buga, Pasto, Rionegro y Popayán, con el propósito deentregar al país, y en particular a sus municipios:

(i) Un software para el montaje, administración y alimentación autónoma por parte de los funcionariosmunicipales, de una página web de la alcaldía, que fortalezca la transparencia de la gestión municipal yque apoye la rendición de cuentas presencial de los alcaldes/alcaldesas.

(ii) Una propuesta metodológica para la realización de audiencias públicas de rendición de cuentas delAlcalde/Alcaldesa a la ciudadanía.

Para el logro de sus propósitos, el proyecto: (i) diseñó y montó participativamente un modelo o estándar mínimo depágina web de la alcaldía, (ii) diseñó una metodología para la Rendición de Cuentas del Alcalde/Alcaldesa, y lapropuso a 4 alcaldes que participaron en el proyecto, para su prueba y ajuste (iii) desarrolló un modelo deadministración de la página con el software Aplicaciones de Acción de APC (www.apc.org/actionapps/) para garantizarautonomía de la Alcaldía en su manejo, y garantizar procedimientos sencillos para la permanente alimentación de lamisma por parte de los funcionarios y brindar con ello la oportuna información a la ciudadanía, (iv) apoyó a las alcaldíasvinculadas al proyecto en la divulgación de las páginas en medios masivos de comunicación y en su lanzamiento, (v)desarrolló el software con programas de libre circulación para aliviar de costos a las administraciones y estimular eldesarrollo tecnológico en el país, (vi) montó el software bajo estándares internacionales de accesibilidad paragarantizar al conjunto de ciudadanos, incluidos aquellos con limitaciones visuales, el acceso a la información (vii)capacitó a miembros de organizaciones sociales, interesadas en control social, de los cuatro municipios, en el uso delInternet y en la comprensión de la información publicada en las páginas, y les dio acceso gratuito a horas de Internet,para consulta por fuera de las horas de capacitación, animando a la vigilancia de la administración municipal, (viii)realizó una evaluación de impacto del desarrollo de las páginas en los cuatro municipios, y (ix) animó a los municipios aintroducirse en el concepto de alcaldías electrónicas o e-government.

Para el diseño del modelo básico de página, 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 asumirían las labores de alimentar lapágina como autores y como editores, y miembros de organizaciones sociales, en especial aquellas pertenecientes alconsejo municipal de planeación de cada un de los cuatro municipios del proyecto.

Para las organizaciones ejecutoras, el desarrollo del proyecto “Internet para la Rendición de Cuentas del AlcaldeMunicipal" fue una experiencia maravillosa de construcción y de encuentro con los funcionarios y funcionarias de lascuatro alcaldías y con los miembros de organizaciones sociales, que se involucraron. A ellos, lo mismo que a losfinanciadores, damos nuestros agradecimientos por la oportunidad que nos dieron de hacer realidad esta herramienta.Esperamos que el uso de las nuevas tecnologías de la informática y las comunicaciones, a través del paquete demateriales que hoy presentamos, contribuya al fortalecimiento del cuidado de lo público en el país, al impulso de unacultura de la rendición de cuentas de nuestros servidores públicos, a la vigencia del principio de la transparencia de losasuntos del Estado, y a la ampliación de la participación ciudadana.

ROSA INES OSPINA ROBLEDO JULIAN CASASBUENASDirectora Ejecutiva DirectorCorporación Transparencia por Colombia Colnodo

CONTENIDO

1.1. Programas y equipos requeridos............................................................................................................31.1.1. Programas.............................................................................................................................................31.1.2. Equipos.................................................................................................................................................31.2. Instalación de PhpMyAdmin (opcional)....................................................................................................41.3. Instalación de las Aplicaciones de Acción...............................................................................................51.3.1. Creación de la base de datos de las Aplicaciones de Acción...............................................................61.3.1.1. Desde Línea de comando..................................................................................................................61.3.1.2. Desde Phpmyadmin...........................................................................................................................71.3.2. Configuración del Sistema..................................................................................................................111.3.3-. Creación del usuario superadministrador de las Aplicaciones de Acción:........................................141.3.4. Cambio de clave usuario superadministrador de las Aplicaciones de Acción:...................................15

2

I. Instalación del Sistema _____________________________

Durante el siguiente instructivo se debe tener en cuenta que la palabra municipio debe ser reemplazada porel nombre del municipio correspondiente a la instalación en proceso

1.1. Programas y equipos requeridos.

1.1.1. Programas

El sistema funciona con las Aplicaciones de Acción de APC (http://www.apc.org/actionapps). Para lainstalación de las Aplicaciones de Acción 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/. Elservidor web es el encargado de atender las solicitudes de los visitantes de las páginas a través deInternet.

Php 4.3.2 o superior. Obtenga Php de http://www.php.net/. Php es el lenguaje de programaciónutilizado por las Aplicaciones de Acción.

MySQL 4.0 o superior. MySQL es el servidor de bases de datos que se encarga de elalmacenamiento de los datos del sistema.

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

1.1.2. Equipos

Dadas las características del sistema se recomienda que la instalación se realice en un servidor con altacapacidad de memoria y de almacenamiento en disco conectado a Internet. Dentro de la gama deservidores compatibles con sistema operativo Linux se encuentran las marcas Dell, IBM y Compaq (o HP).

Un servidor típico económico puede tener las siguientes características:

• Sistema Base Procesador 2.0GHz/Caché 512K/Bus Frontal 533MHz• Memoria 1GB RAM • Controladora Primaria Discos contectados a controladora interna SCSI• Configuración 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 Estándar para Windows

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

1 Todas las aplicaciones requeridas para la instalación del sistema son de Software Libre y no requieren del pago de licenciamiento por parte delos municipios para su utilización. Los paquetes necesarios que fueron utilizados durante el desarrollo del proyecto se incluyen en el CDRom dela distribución para Windows y Linux.

3

El servidor debe conectarse a Internet a través de su tarjeta de red.

Sin embargo, el sistema se puede instalar en un computador de escritorio (para pruebas), para lo cual serecomienda un computador pentium con una memoria en RAM de 128M y espacio en disco de 1 GB.

1.2. Instalación de PhpMyAdmin (opcional)

Para facilitar la administración de las bases de datos se recomienda realizar la instalación de PhpMyAdmin.Phpmyadmin es una aplicación en php que permite realizar de manera gráfica la administración de las basesde datos de MySQL a través de un navegador. Esta herramienta permite facilitar el proceso de creación y mantenimiento de la base de datos utilizadas porlas Aplicaciones de Acción.

Usted puede obtener esta herramienta en http://www.phpmyadmin.net/.

La instalación del sistema se realiza simplemente descomprimiendo el archivo phpMyAdmin que seencuentra en el directorio phpmyadmin del CD de municipios. Descomprímalo 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 quefuncionará en el URL http://municipio.gov.co/phpmyadmin/

Antes de poder utilizar la herramienta es necesario editar el archivo de configuración config.inc.php ydefinir la clave de acceso del superadministrador (root) así:

$cfg['Servers'][$i]['user'] = 'root'; // MySQL user$cfg['Servers'][$i]['password'] = 'clave asignada'; // 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 siguientepantalla:

4

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

1.3. Instalación de las Aplicaciones de Acción

En el CD de Instalación del sistema Usted encontrará 4 archivos que contienen:

apc-aa-municipio.tar.gz: Contiene los canales y estructura del sitio. Descompacte este archivo enla carpeta apc-aa-municipio de su servidor de Internet.

apc-aa-files-municipio.tar.gz. Contiene los gráficos del sitio. . Descompacte este archivo en lacarpeta apc-aa-files-municipio de su servidor de Internet. Esta carpeta debe tener permisos deescritura para el servidor de Internet para permitir la publicación de gráficos en el sistema.

aa-municipio.sql: Archivo con información de la base de datos SQL del sistema.

municipio.tar.gz: Carpetas con las páginas estáticas, hojas de estilo e imágenes asociadas al sitio.Descompacte este archivo en la carpeta municipio de su servidor de Internet.

5

Importante: Todas las instrucciones del proceso de instalación que se presentan a continuación utilizan lapalabra 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 direcciónhttp://www.municipio.gov.co y se está realizando la instalación para el municipio de Pereira la direccióndeberá ser http://www.pereira.gov.co

Por ejemplo, para el municipio de Pasto una estructura de directorios de una instalación típica deberá versede la siguiente manera:

Nivel inferior a raíz servidor web pastoapc-aa-pastoapc-aa-files-pasto

1.3.1. Creación de la base de datos de las Aplicaciones de Acción.

1.3.1.1. Desde Línea de comando.

Si Usted no está familiarizado con el montaje de bases de datos de MySQL desde la línea de comandos lerecomendamos continuar el proceso de instalación como se describe en la siguiente sección utilizandophpmyadmin.

Desde línea de comandos ejecute:

mysqladmin -u root -p create aa-municipioEnter password:

Para crear la base de datos aa-municipio. Usted deberá conocer y dar la clave de administrador (root) delservidor MySQL.

Para cargar los datos a la base de datos ejecute:

mysql -u root -p aa-municipio < aa-municipio.sqlEnter password:

mysql –u root –p mysqlEnter password:

Cree el usuario que accederá la base de datos de las Aplicaciones de Acción:

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 Acción 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 parámetros de las tablas de las bases de datos pueden variar entre versiones deMySQL y es posible que los comandos acá mostrados no funcionen para ciertas versiones de MySQL.

6

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 deAcción:

Seleccione la base de datos Mysql

7

y posteriormente la tabla user:

Seleccione la opción “Insertar nueva fila”.

Cree un usuario para la base de datos asignando las siguientes variables:

Host: localhostUsuario: adminPassword: (clave asignada por Usted)

Importante: Tenga presente que en el campo password debe asignar la función password. Este será elnombre de usuario y clave que Usted deberá utilizar en la configuración de las Aplicaciones de Acción comose explicará más adelante.

Deje todos los permisos del usuario en NO.

8

Seleccione el botón “Continue” para grabar los cambios. La nueva entrada deberá reflejarse en la lista deusuarios de la Base de Datos de Mysql:

Posteriormente se deben asignar los permisos a la base de datos al usuario recién creado así:

Seleccione la tabla DB de MySql y a continuación la opción “Insertar nueva fila”:

Defina los campos así:

Host: localhostDb: aa-municipioUser: admin

9

Y asígnele 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. Paraesto, seleccione examinar utilizando la ejecución de secuencias de SQL en la Base de Datos aa-municipioque se encuentra en el archivo aa-municipio.sql:

Después de seleccionar el archivo aa-municipio.sql presione el botón Continúe. 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 ejecuciónle recomendamos actualizar la base de datos manualmente utilizando el comando:

mysql -u root -p aa-municipio < aa-municipio.sql

Reinicie MySQL.

1.3.2. Configuración del Sistema

Descomprima en su directorio (p.e. htdocs, inetpub, wwwroot) del servidor de Internet el archivo apc-aa-municipio.tar.gz, apc-aa-files-municipio.tar.gz y municipio.tar.gz. Vea la sección 1.3 con recomendaciones dela estructura de directorios para la instalación.

Edite el archivo de configuración de apache httpd.conf y agregue los siguientes datos:

Para windows (reemplace las negrillas por los valores correspondientes a su instalación)<VirtualHost dirección IP del servidor>ServerName www.municipio.gov.coServerAlias municipio.gov.co DocumentRoot “c:/apache/htdocs/municipio”ErrorLog logs/municipio.error.logCustomLog logs/municipio.access.log commonAlias /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 FollowSymLinksDirectoryIndex index.shtml sitio.shtml index.php index.html index.htm</Directory></VirtualHost>

11

Para linux<VirtualHost dirección IP del servidor>ServerName www.municipio.gov.coServerAlias municipio.gov.co DocumentRoot /var/www/municipioErrorLog /var/log/apache/municipio.error.logCustomLog /var/log/apache/municipio.access.log commonAlias /apc-aa /var/www/apc-aa-municipioAlias /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 FollowSymLinksDirectoryIndex index.shtml sitio.shtml index.php index.html index.htm</Directory></VirtualHost>Reinicie el servidor Web.Posteriormente edite el archivo de configuración de las Aplicaciones de Acción config.php3 que seencuentra en el directorio /apc-aa-municipio/include, y configure los siguientes parámetros:

AA_BASE_PATH. Defina el directorio de las Aplicaciones de Acción. Debe colocarse una ruta absoluta.$AA_BASE_PATH = "/var/www/apc-aa-municipio/";Coloque la ruta correspondiente de acuerdo con su instalación.

AA_INSTAL_URL. Este parámetro define el URL en donde quedan instaladas las Aplicaciones deAcción:

define("AA_INSTAL_URL", "http://www.municipio.gov.co/apc-aa/"); DEFAULT_ORG_ID. Define el dominio en donde se encuentran las AA.define("DEFAULT_ORG_ID", "municipio.gov.co");

Configuración de los parámetros de la base de datos:• 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 Acción.• 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 Acción. Si Usted va a intercambiarcontenido entre sitios debe cambiar este parámetro. En cualquier caso se recomienda cambiarlo. Debeser exactamente de 32 caracteres y debe contener números y letras de la A hasta la F inclusive. Esteidentificador puede obtenerse desde Linux con el comando:

head /dev/urandom | md5sumdefine("AA_ID", " e25e3c7f22866b03698bcb38a8137adb");

PERM_LIB. Sistema de permisos utilizado. Debe ser SQL:define("PERM_LIB", "sql"); ERROR_REPORTING_EMAIL. Dirección de correo electrónico a quien se envían reportes de error de

las Aplicaciones de Acción:define("ERROR_REPORTING_EMAIL", "usuario@municipio.gov.co");

DEFAULT_LANG_INCLUDE. Idioma por defecto. Para español utilice es_news_lang.php3define("DEFAULT_LANG_INCLUDE", "es_news_lang.php3");

Parámetros de imágenes. • IMG_UPLOAD_MAX_SIZE. Define el tamaño máximo de imágenes que aceptará el sistema.• define("IMG_UPLOAD_MAX_SIZE", "400000");• IMG_UPLOAD_URL. Directorio en donde se copian las imágenes que utilizarán las Aplicaciones

de Acción. Nótese que el directorio indicado aquí (apc-aa-files-municipio en el ejemplo) debeexistir bajo el directorio (p.e. htdocs, inetpub, wwwroot) en el servidor de Internet. Igualmente sedeben 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 imágenes:• define("IMG_UPLOAD_PATH", "/var/www/apc-aa-files-municipio/");

Posteriormente edite el archivo site_municipios.php3 que se encuentra en el directorio /apc-aa-municipio/modules/site/sites y defina el nombre del municipio que aparecerá en el encabezado del sitio enel siguiente parámetro:

'municipio' => 'Municipio'Por ejemplo, si su municipio es Pereira la línea deberá quedar:'municipio' => 'Pereira'

13

1.3.3. Creación del usuario superadministrador de las Aplicaciones de Acción:

Acceda a la dirección: http://www. municipio .gov.co/apc-aa/admin/setup.php3

Este vínculo solo funcionará una vez.

Recomendamos eliminar el archivo setup.php3 para evitar accesos indebidos a la configuración del sistema.

Seleccione el botón Instalar y digite la información requerida para la cuenta de super administrador de lasAplicaciones de Acción:

Con lo que el sistema contestará:

14

1.3.4. Cambio de clave usuario superadministrador de las Aplicaciones de Acción:

Una vez concluido el proceso de instalación Usted podrá ingresar al sistema a través del URL:

http://www.municipio.gov.co/apc-aa/admin/

y deberá acceder a la pantalla de validación de usuarios del sistema:

Entre como usuario superadministrador del sistema con nombre de usuario y contraseña recién creada

Para asignar una nueva clave al superadministrador del sistema ingrese a la opción AA y posteriormenteEditar Usuario:

15

A continuación diligencie el formulario para la cuenta del superadministrador del sistema:

Defina una nueva clave y verifíquela. Cerciórese que la opción “Cuenta de superadministrador” estéactivada.

Importante: La seguridad de su sistema dependerá de la clave que Usted asigne a la cuenta delsuperadministrador. En lo posible tenga en cuenta:

• Una buena clave reúne combinación de mayúsculas, minúsculas, números y símbolos. Además, esaconsejable que los números y/o símbolos aparezcan en medio de la clave, y no al principio o final. Serecomienda que la nueva clave tenga por lo menos 6 caracteres, y que cumpla unos mínimos requisitosde 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 fácil de recordar, por ejemplo: "La vaca que rie vía melgar- 9" corresponde a la clave LvqrvM-9. *NO utilice este ejemplo como clave*

• La clave debe tener mínimo:

- 6 caracteres- Debe ser distinta de la actual (admin).- Debe contener letras y números.- Puede contener caracteres como $ ! % - _ /. ; ,

16

Diligencie el formulario y teclee el botón “Actualizar” al final de la página para guardar los cambios.

Entre al sistema y edite el canal “Sitio Municipio” y la opción “Module Settings” para determinar elidentificador 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"-->

Nótese que el Id corresponde al que se muestra en la pantalla del Administrador de sitios.

Cerciórese que el URL corresponda a su dominio:

http://municipio.gov.co/sitio.shtml

Finalmente cerciórese de tener un vínculo en el directorio de Internet del sistema desde index.shtml alarchivo 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

Refiérase al capítulo 5 de este manual para efectuar la administración de su sistema.

En este nivel Usted ya deberá poder acceder al sitio del municipio a través de la direcciónhttp://www.municipio.gov.co/ (o http.//localhost/ si no se ha registrado aun el dominio de su municipio).

17