Implementacin

App Conexion12
Fase 3 Capacitacin Destino

Marzo 3 de 2015, Versin 1.0

INDICE DE CONTENIDOS
1.

ANTECEDENTES DEL PROYECTO................................................................................................. 3

2.

SISTEMA DESARROLLADO E INSTALACIN.......................................................................... 4

2.1. TECNOLOGA UTILIZADA...................................................................................................................... 4
2.2. ARQUITECTURA DEL SOFTWARE.......................................................................................................... 4
2.2.1.
Modelo Vista Controlador (MVC)...................................................................................... 4
2.2.2.
Framework 4.5.1.................................................................................................................... 5
2.3. BASE DE DATOS................................................................................................................................... 5
2.4. DATOS PARA LA INSTALACIN.............................................................................................................. 7
2.4.1.
Instalacin............................................................................................................................... 7
2.4.2.
Configuracin de Base de Datos...................................................................................... 8
2.4.3.
Publicacin de la Aplicacin.............................................................................................. 9

3.

MDULOS DEL SISTEMA.............................................................................................................. 10

1. Antecedentes del Proyecto

El proyecto App Conexion12 Fase III Capacitacion Destino tiene por objetivo lograr la
implementacin de una solucin tecnolgica que permita apoyar la gestin y el control de avance
de la Visin G12 en el programa de enseanza CAPACITACIN DESTINO que orienta y profundiza al
estudiante en temas doctrinales de amplia aplicabilidad, que le motivan a una continua
autoformacin, y a mejorar su caminar con Dios.

La implementacin de la solucin tecnolgica se desarroll en dos etapas:

Primera etapa de consultora en el levantamiento de requerimientos y diagnstico de
software y de diseo de la solucin (Figura 1).
Como resultado de la primera etapa, se dise la solucin tecnolgica (descrita en
Informe de la Etapa 1).
Diagnstico de
Soluciones de
Software

Anlisis de Resultados
Construccin Propuesta de Solucin

Levantamient
o de
Requerimeint

Propuesta de
Solucin

Figura 1: Primera etapa del proyecto.

Segunda etapa de implementacin de la solucin tecnolgica.

En este informe de entrega del sistema (solucin tecnolgica) se describen aspectos tcnicos
de implementacin e instalacin del sistema.

2. Sistema Desarrollado e Instalacin

2.1. Tecnologa Utilizada
Desde el punto de vista del diseo e implementacin del sistema, se incorpor el uso de
programas de apoyo al anlisis, modelamiento, diseo y especificacin, desarrollo, pruebas,
monitoreo de stress, entre otros. Los prototipos fueron evaluados por la contraparte del
presente proyecto. La arquitectura desarrollada consider las siguientes dimensiones:

Ambiente de desarrollo basado en Visual Studio 2012, Lenguaje de Programacin

Visual Basic .Net, Entity Framework.
Base de datos SQL Server 2012
Herramienta de control de versiones Team Explorer
Diseo: Utilizacin de Template Vendroid
Desarrollo: Utilizacin de Framework 4.5.1 para programacin en cdigo Visual
Basic .Net, Entity Framework 6.2, javascript, xml y html. Libreras jQuery, Librera de
Exportacin a Excel, ClosedXML Open Source.

2.2. Arquitectura del Software

El software construido se basa en el esquema Modelo Vista Controlador (MVC) utilizando el
framework 4.5.1.
2.2.1. Modelo Vista Controlador (MVC)
La arquitectura MV (Ver Figura 2) separa el modelo (abstraccin de los mdulos y procesos
de la solucin) y la vista (la presentacin visual del sistema al usuario) por lo que obtiene
una arquitectura ms simple de construir y mantener.
El controlador, corresponde a los componentes de software que separan al modelo y la
vista de los detalles de los mecanismos internos utilizados (protocolo) para las peticiones de
informacin (HTTP, consola de comandos, email, etc.).
El modelo se encarga de la abstraccin de la lgica relacionada con los datos, haciendo que
la vista y las acciones sean independientes de, por ejemplo, el tipo de motor de bases de
datos a utilizar.

Usuario
(1) Solicita
Figura 2: Esquema MVC

2.2.2. Framework Yii PHP

Controlador

(4) Enva

Modelo

Yii es un framework (5)

PHP
basado
Procesa
y Enva en componentes de alto rendimiento para desarrollar
(3) Solicita/Retorna
(2) Invoca
aplicaciones Web de gran escala. El mismo
permite la mxima reutilizacin en la
programacin web y puede acelerar el proceso de desarrollo. Yii es un framework totalmente
basado en OOP (Programacin Orientada a Objetos).
Vista

2.3. Base de Datos

Base de Datos

El motor de base de datos es SQL Server 2012 versin 5.0.95 posee ms de 60 tablas
(entidades). A continuacin se presenta el modelo de entidad-relacin de esta base de datos.

Figura 3: Base de Datos del Sistema

NOTA: Se hace presente que el diccionario de datos ser incorporado en el Informe

Sistema en Produccin y Documentacin Asociada

2.4. Datos para la Instalacin

Para instalar el sistema es necesario seguir las siguientes instrucciones:
2.4.1. Instalacin.
IMPORTANTE: Se asume que el encargado de realizar la instalacin posee conocimientos
bsicos sobre administracin de sistemas GNU/Linux y configuracin de servicios sobre esta
plataforma.
Para comenzar es necesario descargar la versin 1.1.12 del framework Yii desde la siguiente
ubicacin: http://www.yiiframework.com/download/
Una vez descargado el paquete, se debe descomprimir bajo la ruta /var/www/yii.
Asumiendo que el archivo yii-1.1.12.tar.gz se encuentra en el directorio /root, se deben
ejecutar los siguientes comandos en modo administrador:
#
#
#
#

cp /root/yii-1.1.12.tar.gz
cd /var/www
tar zxvf yii-1.1.12.tar.gz
mv yii-1.1.12 /var/www/yii

/var/www

La actualizacin del PATH, como se muestra a continuacin, slo modifica el ambiente del
shell donde se ejecute; para realizar esta actualizacin de manera perdurable en el
tiempo debe agregarse al final del archivo ~/.profile (para el usuario en sesin) o
/etc/profile (para todos los usuarios del equipo).
# PATH=/var/www/yii/framework:$PATH

Para validar el proceso de instalacin, es necesario ingresar a la siguiente url y verificar que
todos los componentes estn correctamente instalados, de lo contrario se deben
solucionar los problemas antes de continuar.
http://hostname/YiiPath/requirements/index.php

En donde hostname corresponde al servidor en donde se instal la aplicacin.

Una vez configurado e instalado Yii, debemos proceder a copiar el archivo con la aplicacin
(por ejemplo GORELosLagos.zip) a la ruta /var/www/ en donde se descomprimir el
contenido del archivo zip/rar, proceso tras el cual se crean los directorios y archivos para el
correcto funcionamiento del sistema quedando en el directorio /var/www/gore.

TIDE S.A.
PORVENIR 746 / TEMUCO , CHILE - FONO: (56-45) 742242 - FAX: (56-45) 244944

Para realizar lo anterior, se deben ejecutar los siguientes comandos en modo administrador:

#cp /root/GORE.zip /var/www

#cd /var/www
#unzip GORE.zip

A continuacin es necesario cambiar el propietario de los archivos de la aplicacin para que

el servidor web tenga acceso a todos los archivos con permisos de lectura y escritura,
para esto es necesario ejecutar:
#chown -R www-data:www-data gore/

NOTAS:
Se hace presente que la ruta en donde se descomprima el proyecto puede ser la que
el operador estime conveniente
Se recomienda establecer la configuracin del servidor web para que no enliste
directorios, mediante el uso, por ejemplo, de un archivo de configuracin
.htaccess que contenga la directiva Options -Indexes, ya que podran ser visibles
los archivos fuente del proyecto, incluido el archivo main.php que mantiene
informacin de acceso a la base de datos, lo que podra resultar en una posible
brecha de seguridad.
2.4.2. Configuracin de Base de Datos.
Para configurar el entorno de ejecucin del sistema es necesario editar algunos campos del
archivo main.php que se encuentra en el directorio protected/config/main.php del proyecto
que se acaba de instalar.
En este archivo se especifican datos de acceso al servidor de base de datos que usar la
aplicacin:
'db'=>array(
'connectionString' => mysql:host=IP_servidor;dbname=nombre_bd,
'tablePrefix' => '',
'emulatePrepare' => true,
'username' => nombre_usuario,
'password' => password,
'charset' => 'utf8',
),

TIDE S.A.
PORVENIR 746 / TEMUCO , CHILE - FONO: (56-45) 742242 - FAX: (56-45) 244944

Una vez que se encuentre configurada la conexin entre la aplicacin y la base de datos,
si no se ha creado la base de datos se debe crear manteniendo los datos consistentes con
los definidos en el archivo main.php.
Si se cuenta con un archivo con extensin sql (por ejemplo goreloslagos.sql), se debe
ejecutar una instruccin como la siguiente, desde el mismo directorio en donde reside el
archivo goreloslagos.sql.
#mysql -uroot -h mysql.example.com goreLosLagos< gore.sql -p

El servidor de base de datos MySQL en este momento solicitar que se ingrese la password
del usuario root de MySQL (o del usuario autorizado que se est haciendo uso)
Tras lo cual, la nueva base de datos creada en MySQL ser poblada con los modelos de
datos del sistema de planificacin institucional. Una vez establecidas estas configuraciones,
se procede a especificar la forma en que el servidor web Apache manejar esta aplicacin.

2.4.3. Publicacin de la Aplicacin.

Existen distintas formas de publicar este tipo de aplicaciones web usando Apache, por lo que
la metodologa usada en este documento solo servir como un referente, pero est a criterio
del administrador de sistemas usar la que ms se acomode a las necesidades de la
institucin. Se recomienda usar la metodologa de host virtuales, por un tema de
simpleza, adems de ser un mtodo menos invasivo con la configuracin propia del
servidor web, ya que solo se crean archivos con distintas configuraciones para cada nueva
aplicacin de ste tipo que se desee publicar, sin intervenir el archivo de configuracin de
Apache, apache2.conf.
Para realizar lo anterior se debe crear nuevo archivo de configuracin en el directorio
/etc/apache2/sites-available/nombre_sitio con el siguiente contenido:
<VirtualHost *>
#Direccin web a la cual responder el servidor web
ServerName
www.nombresitio.com
#Ruta donde se descomprimi la aplicacin
DocumentRoot /var/www/gore/
</VirtualHost>

TIDE S.A.
PORVENIR 746 / TEMUCO , CHILE - FONO: (56-45) 742242 - FAX: (56-45) 244944

14

Una vez creado este archivo se debe ejecutar la siguiente instruccin en modo administrador
(root) desde la consola desde la cual se opera.
#a2ensite nombre_sitio

Con lo cual se crea un enlace simblico del archivo /etc/apache2/sitesavailable/nombre_sitio en la ruta /etc/apache2/sites-enabled/nombre_sitio, directorio en
donde residen las configuraciones de los proyectos que debe cargar Apache en su arranque.
Luego solo es necesario reiniciar el servidor web para que reconozca la configuracin del
nuevo proyecto mediante el comando:
#/etc/init.d/apache2 reload

Realizando todos los pasos detallados anteriormente la aplicacin se encuentra lista para ser
publicada, solo resta configurar el servidor DNS de la red para que encamine el trafico de la
url http://www.nombresitio.com a la IP del servidor que se acaba de configurar.

3. Mdulos del Sistema

Se ampla en informe anexo de Mdulos del Sistema.