Pontificia Universidad Catlica de Chile. Escuela de Ingeniera. Departamento de Ciencia de la Computacin.

Manual de instalacin Sistema de Gestin Documental para la Municipalidad de La Florida

Sigla Profesor Alumnos

: IIC2153 : Rodrigo Sandoval : Claudio Bravo C. Christian Cafatti Leonardo Medina Toms Jara Max Yulis Homero Novoa

Equipo Fecha creacin

: FloridaNet : 12 de Diciembre de 2009

Taller de Especialidad IIC2153

FloridaNet

TABLA DE CONTENIDOS 1. INTRODUCCIN ............................................................................................................... 1 1.1 1.2 2. 3. Introduccin .......................................................................................................... 1 Glosario.................................................................................................................. 1

REQUISITOS DE SISTEMA Y VERSINES .......................................................................... 2 INSTALACIN .................................................................................................................. 2 3.1 3.2 3.3 3.4 3.5 3.6 3.7 Instalacin XAMP y preparacion del ambiente de trabajo. ............................. 2 Instalacin symfony .............................................................................................. 2 Instalacin software .............................................................................................. 3 Configuracion Virtual Host ................................................................................. 3 Cargar datos preestablecidos .............................................................................. 4 Configuracion Apache.......................................................................................... 4 Direccionamiento en red. ..................................................................................... 5

4.

LINKS DE AYUDA ............................................................................................................. 5

1 Manual de instalacin Sistema de Gestin Documental

Taller de Especialidad IIC2153

FloridaNet

1. INTRODUCCIN 1.1 Introduccin El siguiente manual de instalacin entrega las bases para poder hacer una correcta instalacin en un servidor del sistema gestor documental (SGD), el que ha sido desarrollado, para la Ilustre Municipalidad de La Florida, por un equipo de desarrollo, compuesto por alumnos de la Escuela de Ingeniera de la Universidad Catlica de Chile. El sistema corresponde a una aplicacin web montada en un servidor WAMP, propio de la municipalidad, que fue desarrollado en el framework Symfony versin 1.2 A continuacin, se entregan las nociones necesarias para poder utilizar el sistema en forma correcta y completa. 1.2 Glosario Apache: Sistema servidor WEB. MySQL: Motor de base de datos. PHP: Lenguaje de programacin. PhpMyAdmin: Pagina de administracin de PHP WAMP: Es el acrnimo utilizado para describir un sistema de infraestructura internet que utiliza las herramientas Windows como sistema operativo, Apache, MySQL y PHP. Symfony: Plataforma de desarrollo (Framework), sobre la cual se soporta el SGD. XAMP: Software que soporta WAMP (altamente recomendado).

1 Manual de instalacin Sistema de Gestin Documental

Taller de Especialidad IIC2153

FloridaNet

2. REQUISITOS DE SISTEMA Y VERSINES El siguiente tutorial es realizado en la base de un sistema WAMP, por lo tanto los requisitos son para este desarrollo, tambin es posible instalar en sistemas LAMP, de forma analgica. Requisitos bsicos recomendados: Sistema operativo Windows Server 2003 Memoria 1 GB RAM. Memoria 2 TB de disco. Windows explorer 8.0 (como Web browser) PHP 5.3 Apache HTTP server versin 2.2 MySQL 5.1 Symfony 1.2.8 3. INSTALACIN 3.1 Instalacin XAMP y preparacion del ambiente de trabajo. Descargar XAMP, la versin 1.7.2, o superior (esta incluye PHP 5.3, Apache 2.2 y MySQL 5.1), para sistema operativo Windows, en la siguiente pgina http://www.apachefriends.org/en/xampp-windows.html Abrir el archivo ejecutable e instalar XAMP en la carpeta c:/ (De preferencia). Cargar entre las variables de entorno del sistema los comandos de php. Para esto abrir las propiedades de Mi PC Avanzado Variables de entorno, luego en las variables de sistema, editar la variable path y agregar ;C:\xampp\php al final. Abrir el panel de control de XAMP y correr MySQL y Apache. Si todo est en orden, al buscar en Explorer http://localhost, se debe desplegar la pagina de XAMP Luego elegir el idioma Realizar el chequeo de seguridad, es necesario configurar una clave de acceso a XAMP, PhpMyAdmin y MySQL, para lo que se deben seguir las instrucciones en el chequeo de seguridad de XAMP.

3.2 Instalacin symfony Descargar el Symfony 1.2.8 desde la pgina http://www.symfony-project.org/ Descomprimir en la carpeta C:\xampp\symfony.

2 Manual de instalacin Sistema de Gestin Documental

Taller de Especialidad IIC2153

FloridaNet

3.3 Instalacin software La carpeta que aloja el software en XAMP es la carpeta htdocs, ubicada en C:\xampp\htdocs, lo que la convierte en la ubicacin ptima para la carpeta del SGD. Descomprimir el software en la ubicacin C:\xampp\htdocs\SGD (puedes poner otro nombre a la carpeta pero debes asegurar la consistencia en configuraciones posteriores). Para configurar la base de datos, es necesario ingresar al archivo database.yml, ubicado en C:\xampp\htdocs\SGD\config y en la configuracin de dsn, debe aparecer lo siguiente: o dsn: mysql:dbname=sgd;host=localhost Luego en el Explorer acceder a http://localhost/phpmyadmin/, acceder al tab Base de datos y crear una nueva base de datos llamada sgd con cotejamiento utf8_spanish_ci. Entonces, se abre el editor de lneas de comando (Ejecutarcmd) Se accede a la carpeta c:\xampp\htdocs\SGD\ Se ejecuta el comando symfony propel-build-all Y finalmente se confirma la peticin de reseteo de datos.

3.4 Configuracion Virtual Host No es estrictamente necesario, pero si recomendable para testear la correcta instalacin de forma ms expedita. Primero es necesario editar la archivo httpd-vhosts.conf que se ubica en C:\xampp\apache\conf\extra y agregar el direccionamiento con el siguiente cdigo: NameVirtualHost *:80 Listen 127.0.0.2:80 <VirtualHost 127.0.0.2:80> ServerName SGD DocumentRoot "C:\xampp\htdocs\SGD \web" <Directory ""C:\xampp\htdocs\SGD \web"> AllowOverride All Allow from All </Directory> Alias /sf "C:\xampp\symfony\data\web\sf" <Directory "C:\xampp\symfony\data\web\sf"> AllowOverride All Allow from All </Directory> </VirtualHost>

3 Manual de instalacin Sistema de Gestin Documental

Taller de Especialidad IIC2153

FloridaNet

De este modo, se configura como acceso local, el nombre SGD, para ser llamado desde Explorer. Se configura como raz de la documentacin, la carpeta web y acceso a los mtodos de symfony a travs del Alias. Luego se debe configurar en el archivo hosts, ubicado en C:\Windows\System32\drivers\etc y justo bajo la lnea donde aparece: 127.0.0.1 localhost Agregar la ip utilizada en la configuracin anterior: 127.0.0.2 SGD y guardar el archivo (se debe asignar permisos de edicin al archivo para que permita modificarlo). Finalmente, se debe reiniciar el servidor apache en el panel de control de XAMP y luego al buscar en el Explorer la direccin SGD, despliega el software. 3.5 Cargar datos preestablecidos En este punto necesitamos cargar los datos necesarios para poder utilizar el SGD, estos se encuentran preestablecidos en el software (es necesario que se encuentre Apache y MySQL en ejecucin). Primero, se abre el editor de lneas de comando (Ejecutarcmd) Se accede a la carpeta c:\xampp\htdocs\SGD\ Luego, se ejecuta el comando symfony propel-build-all-load Y finalmente se confirma la peticin de reseteo de datos.

Con los datos cargados, el software permite acceder con el usuario admin, clave admin a la vista principal. Luego para acceder a la vista de administrador del SGD, utilizo la URL http://sgd/backend.php y los mismos datos de usuario. 3.6 Configuracion Apache Por ltimo es necesario configurar Apache, con el objetivo de establecer como acceso raz, la carpeta Web, del software del SGD. Para esto, es necesario modificar el archivo httpd.conf, ubicado en C:\xampp\apache\conf, en la linea donde aparece DocumentRoot "C:/xampp/htdocs" Cambiar, para que se direccione, de la siguiente manera DocumentRoot "C:/xampp/htdocs/sgd/web" De esta forma se restringe el acceso al servidor, optimizando el manejo de la seguridad y se direccionan directamente los llamados al servidor desde la red al SGD.

4 Manual de instalacin Sistema de Gestin Documental

Taller de Especialidad IIC2153

FloridaNet

3.7 Direccionamiento en red. Al instalar el servidor en una red, es necesario configurar, en una maquina que resuelve los DNS, el nombre del servidor, para que sea fcilmente reconocible, nuestra recomendacin es que lo llamen sgd, igual como se hizo en el caso del servidor loca. De esta forma se realizan los llamados a la aplicacin utilizando las siguientes URL http://sgd/ http://sgd/backend.php http://sgd/userfrontend.php Vista de funcionario Vista de administrador Vista de solicitante

4. LINKS DE AYUDA Sitio oficial de symfony, se recomienda los primeros tres y los ltimos tres. http://www.symfony-project.org/jobeet/1_2/Propel/es/01 Ayuda para la instalacin de XAMP y Symfony, importante considerar diferencias con Windows Vista. http://davidvega.net/2008/04/26/instalar-symfony-en-windows-vista-con-xampp/ Curso de instalacin de symfony http://www.slideshare.net/javier.eguiluz/curso-symfony-clase-1 Tutorial de instalacin de xamp y symfony http://articles.sitepoint.com/article/symfony-beginners-tutorial

5 Manual de instalacin Sistema de Gestin Documental