MANUAL DE INSTALACIÓN BANCO DE PROYECTOS DE TRABAJO …

MANUAL DE INSTALACIÓN

BANCO DE PROYECTOS DE TRABAJO DE GRADO

PARA LA FACULTAD DE INGENIERIA

Preparado por:

NELSON MARTÍNEZ ÁLVAREZ

JUAN FERNANDO MÚNERA MOLINA

Junio 2019

DESARROLLO DE UN SISTEMA DE INFORMACIÓN PARA EL BANCO DE PROYECTOS

Tecnológico de Antioquia – Institución Universitaria

Tabla de contenido

1. Introducción ................................................................................................................ 7 2. Glosario ....................................................................................................................... 8 3. Objetivos ................................................................................................................... 11

3.1. Objetivo General ............................................................................................... 11 3.2. Objetivo Especifico ........................................................................................... 11

4. INSTALACIÓN ........................................................................................................ 12 4.1. Requerimientos de instalación .......................................................................... 12

4.2. Detalles del CD de instalación .......................................................................... 13 4.3. Procedimiento de instalación ............................................................................ 13

4.3.1. Instalar Composer ..................................................................................... 18 4.3.2. Configurar la aplicación para Xampp y Windows .................................... 21

4.4. Procedimiento de desinstalación ....................................................................... 33

5. Consejos para evitar fallas ........................................................................................ 36 6. Diseño y estructura de la herramienta ....................................................................... 37

6.1. Diccionario de datos ......................................................................................... 37 6.2. Script creación de base de datos ....................................................................... 46 6.3. Interfaz inicial del Sistema ................................................................................ 46

6.4. Interfaz Del Administrador ............................................................................... 47 7. Cibergrafia. ............................................................................................................... 48



2

Tabla de ilustraciones

Ilustración 1. Ejecutar Instalador xampp .......................................................................... 14 Ilustración 2. Componentes xammp ................................................................................. 15 Ilustración 3. Directorio Instalación ................................................................................. 15 Ilustración 4. Información de Xampp ............................................................................... 16 Ilustración 5. Proceso de instalación ................................................................................. 16

Ilustración 6. Proceso de Instalación Xampp en Ejecución .............................................. 17 Ilustración 7. Proceso Instalación Finalizado ................................................................... 17 Ilustración 8. Seleccionar Idioma ..................................................................................... 18 Ilustración 9. Ejecutar Instalador Composer ..................................................................... 18

Ilustración 10. Seleccionar ruta instalación composer ...................................................... 19 Ilustración 11. Registro proxy del sistema para composer ............................................... 19

Ilustración 12. Ejecutar proceso instalación ..................................................................... 20 Ilustración 13. Proceso instalación composer finalizado .................................................. 20 Ilustración 14. Ruta de copia de la aplicación .................................................................. 21

Ilustración 15. Propiedades de Windows .......................................................................... 22 Ilustración 16. Variables de entorno de Windows ............................................................ 22

Ilustración 17. Path de Windows ...................................................................................... 23 Ilustración 18. Agregar PHP al path ................................................................................. 23 Ilustración 19. verificar version PHP ................................................................................ 24

Ilustración 20. Inicar Xampp y Mysql .............................................................................. 24 Ilustración 21. Acceder a PhpMyAdmin .......................................................................... 25

Ilustración 22. Menú creación nueva base de datos .......................................................... 25

Ilustración 23. Crear base de datos de la aplicación ......................................................... 26

Ilustración 24. Definir variables de entorno de laravel ..................................................... 27 Ilustración 25. Acceder a la carpeta de la aplicación ........................................................ 28

Ilustración 26. Instalar dependencias ................................................................................ 29 Ilustración 27. Ejecutar proceso de migración. ................................................................. 30 Ilustración 28. Comando para poner en marcha el servidor de forma local ..................... 31

Ilustración 29. Url aplicación ............................................................................................ 32 Ilustración 30. Acceso como administrador ...................................................................... 32

Ilustración 31. Detener procesos de Xampp y Mysql ....................................................... 33 Ilustración 32. Estado proceso Xampp y Mysql ............................................................... 33 Ilustración 33. Desinstalar Xampp .................................................................................... 34 Ilustración 34. Confirmar desinstalación de Xampp ......................................................... 34

Ilustración 35. Desinstalar Composer ............................................................................... 34 Ilustración 36. Confirmar desinstalación de Composer .................................................... 35 Ilustración 37. Borrar carpeta de aplicación ..................................................................... 35

Ilustración 38. Interfaz del Sistema .................................................................................. 46 Ilustración 39. Interfaz del administrador ......................................................................... 47



7

1. Introducción

Este manual se realiza con los procedimientos necesarios y con la facilidad de una

herramienta de soporte útil, para el proceso de la instalación, puesta en marcha y

desinstalación del software.

En este se encontrará los temas básicos que necesita conocer, para llevar a cabo una

correcta y satisfactoria instalación, tales como: los objetivos generales y específicos de la

instalación de programa, la terminología con la que nos referimos para el paso a paso, la

descripción general del aplicativo, la arquitectura tecnológica, la instalación del sistema.

Requerimientos de instalación, detalles del CD de instalación, procedimiento de

instalación, procedimiento de desinstalación, y la instalación de componentes.

Consejos para evitar fallas, diseño y estructura de la herramienta.

Diagrama de clases, diccionario de datos, script de creación de las tablas, interfaz

inicial del sistema, Interfaz del administrador.

De esta forma se logrará obtener un mejor rendimiento en el aplicativo web.



8

2. Glosario

PHPSTORM: es un entorno de desarrollo integrado (IDE, por sus siglas en inglés)

para sistemas operativos Windows. Soporta múltiples lenguajes de programación

tales como JavaScript, PHP.

MYSQL: es un sistema de manejo de bases de datos del modelo relacional, de código

abierto mantenido por la empresa Oracle.

Script: los scripts son un conjunto de instrucciones generalmente almacenadas en un

archivo de texto que deben ser interpretados línea a línea en tiempo real para su

ejecución, se distinguen de los programas, pues deben ser convertidos a un archivo

binario ejecutable para correrlos.

Ejecutar: es la acción de iniciar la carga de un programa o de cualquier archivo

ejecutable.

Instalación: Detalla el proceso de montaje del sistema.

Configuración: Explica los principales parámetros que deben inicializarse.

Plugins: (complemento) es una aplicación que se relaciona con otra para aportarle

una función nueva y generalmente muy específica.

Framework: Representa una arquitectura de software que modela las relaciones

generales de las entidades del dominio, y provee una estructura y una especial

metodología de trabajo, la cual extiende o utiliza las aplicaciones del dominio



9

Servidor web: Es un programa informático que procesa una aplicación del lado del

servidor

HTTP: Protocolo de transferencia de hipertexto, es un protocolo de comunicación

que permite transferencia de información en la world wide web

Apache: Es un servidor web HTTP de código abierto que para plataformas Unix,

Windows y Macintosh, el cual implementa el protocolo HTTP

HTML: es un lenguaje de marcado que se utiliza en el desarrollo de páginas de

internet, sus siglas corresponden a HYPERTEX MARKUP LANGUAJE

XAAMP: Es una distribución de Apache completamente gratuita que contiene

MYSQL, PHP, PERL.

PHP: PHP Hypertext Preprocessor, es un lenguaje de código abierto, especialmente

adecuado para el desarrollo web y que puede ser incrustado en HTML

Gestor de dependencias: Software que se encarga de administrar las librerías de

terceros para ser usadas en nuestra aplicación.

Composer: es un gestor de dependencias para php

Host Virtual: El término Hosting Virtual se refiere a hacer funcionar más de un sitio

web (tales como www.company1.com y www.company2.com) en una sola máquina.

Los sitios web virtuales pueden estar "basados en direcciones IP", lo que significa



10

que cada sitio web tiene una dirección IP diferente, o "basados en nombres

diferentes", lo que significa que con una sola dirección IP están funcionando sitios

web con diferentes nombres (de dominio). El hecho de que estén funcionando en la

misma máquina física pasa completamente desapercibido para el usuario que visita

esos sitios web.



11

3. Objetivos

3.1.Objetivo General

Implementar y orientar de forma detallada una guía fácil y confiable que especifique al

usuario correctamente cuáles serán los requerimientos técnicos de instalación para el

funcionamiento del sistema y su ejecución.

3.2. Objetivo Especifico

Describir y orientar de forma adecuada y concretamente los procedimientos

elementales para llevar a cabo la instalación y desinstalación del aplicativo.

Ayudar con la capacitación del usuario en la instalación y uso del aplicativo.

Lograr un óptimo rendimiento del aplicativo, mediante instrucciones dadas en el

manual de instalación.

Facilitar los requerimientos técnicos que son necesarios para la puesta en marcha

del sistema.

Mostrar los diferentes diseños utilizados como diagramas de clases, diccionario de

datos y script de las tablas de bases de datos.



12

4. INSTALACIÓN

4.1.Requerimientos de instalación

Requerimientos Software:

La aplicación funciona con el framework laravel 5.4, por ello son necesarios los siguientes

requerimientos del lado del servidor de aplicación apache:

PHP >= 7.0.1

OpenSSL PHP Extension

PDO PHP Extension

Mbstring PHP Extension

Tokenizer PHP Extension

XML PHP Extension

composer (opcional)

MYSQL > 5.7

Sistema operativo (Windows o Linux)

Requerimientos hardware:

Los requerimientos de hardware variaran de acuerdo a la cantidad de usuarios y

transacciones que se realizan en la aplicación, inicialmente se estima el uso de un servidor

con las siguientes características:

Procesador Intel core i5 o superior

Memoria ram 2 gb o superior



13

500 gb de disco duro

4.2. Detalles del CD de instalación

En el CD de instalación contiene dos carpetas establecidas de la siguiente manera:

Una carpeta denominada banco de proyectos, donde se encontrará el código fuente

del aplicativo, junto con las dependencias necesarias para su correcto

funcionamiento, además se utilizaron las migraciones de laravel que permiten

restablecer las tablas de la base de datos.

La segunda carpeta está reservada para los manuales del sistema la cual contiene

dos manuales que son manual del usuario y manual de instalación.

4.3.Procedimiento de instalación

Instalar xammp y mysql

Los requerimientos en software se pueden abarcar con la instalación de xampp, el cual se

encuentra en la carpeta “fuentes ejecutables/ejecutables xampp-windows-x64-7.1.29-1-

VC14-installer” del cd de instalación.



14

Ejecutar el instalador previamente descargado. Ver Ilustración 1. Ejecutar Instalador

xampp

Ilustración 1. Ejecutar Instalador xampp

Seleccionar las siguientes opciones, Ver Ilustración 2. Componentes xammp



15

Ilustración 2. Componentes xammp

Seleccionar la carpeta de instalación por defecto C:\xampp

Ilustración 3. Directorio Instalación



16

Presionar el botón siguiente

Ilustración 4. Información de Xampp

Presionar Siguiente

Ilustración 5. Proceso de instalación



17

Esperar que finalice la instalación

Ilustración 6. Proceso de Instalación Xampp en Ejecución

Dar clic en el botón finalizar

Ilustración 7. Proceso Instalación Finalizado



18

Seleccionamos el lenguaje y guardamos

Ilustración 8. Seleccionar Idioma

4.3.1. Instalar Composer

Una vez instalado xampp debemos instalar composer el cual permitirá actualizar o instalar

las librerías del proyecto, composer lo podemos encuentra en la carpeta “fuentes

ejecutables/ejecutables/ Composer-Setup.exe” del cd de instalación

Ejecutar el instalador descargado y seleccionar la opción next

Ilustración 9. Ejecutar Instalador Composer



19

Seleccionar la ubicación donde está instalado php y presionar next

Ilustración 10. Seleccionar ruta instalación composer

Si existe un proxy que controla el acceso a internet configurarlo si no presionamos

next

Ilustración 11. Registro proxy del sistema para composer



20

Presionar el botón install

Ilustración 12. Ejecutar proceso instalación

Presionar el botón finish

Ilustración 13. Proceso instalación composer finalizado



21

4.3.2. Configurar la aplicación para Xampp y Windows

Los siguientes pasos para desplegar la aplicación corresponden al uso de xampp en el

sistema operativo Windows las rutas de los archivos de configuración pueden variar según

el sistema operativo o el servidor con apache seleccionado.

Una vez instalados estos dos componentes, el siguiente paso es copiar la carpeta

del proyecto “fuentes ejecutables/bdapp” que se encuentra en dvd de instalación,

en la carpeta htdocs de xampp “C:\xampp\htdocs”

Ilustración 14. Ruta de copia de la aplicación



22

Agregar php a nuestras variables del sistema, ingresar al panel de control, luego a

sistema y seleccionar configuración avanzada del sistema

Ilustración 15. Propiedades de Windows

Ilustración 16. Variables de entorno de Windows



23

Ilustración 17. Path de Windows

Ilustración 18. Agregar PHP al path



24

Verificar si php esta como variable global para ello ejecutamos en la consola de

Windows php –version

Ilustración 19. verificar version PHP

Inicializar el servidor xampp y mysql

Ilustración 20. Inicar Xampp y Mysql



25

Acceder a phpMyAdmin para crear la base de datos de la aplicación

http://localhost/phpmyadmin/

Ilustración 21. Acceder a PhpMyAdmin

Clic en nueva

Ilustración 22. Menú creación nueva base de datos

http://localhost/phpmyadmin/



26

Ingresar el nombre de la base de datos bpapp y click en crear

Ilustración 23. Crear base de datos de la aplicación

Editar el archivo .env ubicado en la raíz de la aplicación, se edita el nombre del host

o ip, el puerto donde está corriendo mysql, el nombre de la base de datos y las

credenciales de autenticación a mysql, por defecto con xampp el usuario es root y

sin clave.



27

Ilustración 24. Definir variables de entorno de laravel

Abrir una consola de Windows y ejecutar el siguiente comando “cd

C:\xampp\htdocs\serviapp”



28

Ilustración 25. Acceder a la carpeta de la aplicación

En consola de Windowsy ejecutar el comando composer install el cual permite

instalar las dependencias del proyecto



29

Ilustración 26. Instalar dependencias

En consola de Windows y ejecutar el comando php artisan migrate, el cual se

encargará de ejecutar los archivos de migración de laravel que crean todas las tablas

necesarias para la base de datos



30

Ilustración 27. Ejecutar proceso de migración.



31

En la consola de Windows ejecutar el comando php artisan serv

Ilustración 28. Comando para poner en marcha el servidor de forma local



32

Abrir navegador deseado y acceder a la siguiente url http://127.0.0.1:8000/

Ilustración 29. Url aplicación

Ingresar el usuario administrador por defecto es [email protected] y la contraseña

es “password”

Ilustración 30. Acceso como administrador

http://127.0.0.1:8000/

mailto:[email protected]



33

4.4.Procedimiento de desinstalación

Desinstalar xammp y mysql

Detener los servicios de xamp y mysql

Ilustración 31. Detener procesos de Xampp y Mysql

Ilustración 32. Estado proceso Xampp y Mysql



34

En el administrador de programas de Windows, buscar xampp clic derecho

desinstalar

Ilustración 33. Desinstalar Xampp

Confirmar la desinstalación

Ilustración 34. Confirmar desinstalación de Xampp

Desinstalar composer

En el administrador de programas de Windows, buscar composer clic derecho

desinstalar

Ilustración 35. Desinstalar Composer



35

Confirmar la desinstalación

Ilustración 36. Confirmar desinstalación de Composer

Borrar contenido de la carpeta xampp

Ilustración 37. Borrar carpeta de aplicación



36

5. Consejos para evitar fallas

Seguir correctamente las instrucciones dadas en los documentos, tanto en manual de

técnico y manual de usuario para evitar problemas y fallos en el sistema y/o equipo.

Debe recordar también, que debe utilizar PHP versión 7 O SUPERIOR, para el correcto

funcionamiento del aplicativo, de lo contario, este puede presentar fallas al momento de

utilizarlo.

Configurar de forma adecuado el archivo .env de laravel para que se conecte a la base de

datos seleccionada.

La base de datos debe estar vacía para poder ejecutar el proceso de migración

Verificar que las librerías necesarias enunciadas anteriormente estén instaladas en php.

Utilizar los comandos artisan de laravel para la creación de las tablas y sus registros

Una vez se ingrese con el usuario administrador crear uno nuevo o cambiar la clave por

defecto.

Importante cambiar las credenciales de acceso a mysql una vez instalado.



37

6. Diseño y estructura de la herramienta

6.1. Diccionario de datos

academic_degrees

Field Type Key Null Default Comment

id int(10) unsigned PRI NO

created_at timestamp

YES

updated_at timestamp

YES

name_es varchar(191)

NO

name_en varchar(191)

NO

countries




YES


YES

name varchar(191)

NO

code varchar(191)

NO

draft_requests

Field Type Key Nul

l

Defaul

t

Commen

t

created_at timestamp YE

S



38

updated_at timestamp YE

S


adviser_id int(10) unsigned MU

L

YE

S

title varchar(191)

NO

description text

NO

overall_objectiv

e text

NO

type enum('develop','research')

NO

status enum('new','approved','rejecte

d')

NO

event_attachments




YES


YES


permission_id int(10) unsigned PRI NO

model_type varchar(191) PRI NO

model_id bigint(20)

unsigned PRI NO



39

type enum('url','file')

NO

route text

NO

project_event_id int(10) unsigned MUL YES

migrations



migration varchar(191)

NO

batch int(11)

NO

model_has_permissions model_has_roles


role_id int(10) unsigned PRI NO

model_type varchar(191) PRI NO

model_id bigint(20)

unsigned PRI NO

notifications


id char(36) PRI NO

type varchar(191)

NO

notifiable_type varchar(191) MUL NO

notifiable_id bigint(20)

unsigned

NO

data text

NO

read_at timestamp

YES


YES



40


YES

password_resets


email varchar(191) MUL NO

token varchar(191)

NO


YES

permissions



name varchar(191)

NO

guard_name varchar(191)

NO


YES


YES

project_events




YES


YES

event_type enum('assigned','updated','message')

NO

description text

YES

project_id int(10) unsigned MUL YES

user_id int(10) unsigned MUL YES



41

project_request_students




YES


YES

student_id int(10) unsigned MUL YES

project_request_id int(10) unsigned MUL YES

project_requests

Field Type Key Nul

l

Defaul

t

Commen

t


created_at timestamp YE

S

updated_at timestamp YE

S

status enum('requested','accepted','rejecte

d')

NO

user_updat

e int(10) unsigned

MU

L

YE

S

project_id int(10) unsigned MU

L

YE

S

projects

Field Type

id int(10) unsigned



adviser_id int(10) unsigned

assignment_da

te date



42

title varchar(191)

description text

stage enum('proposal','draft')

key_words text

overall_objecti

ve text

type enum('develop','research')

status

enum('new','assigned','requested','ApprovedWithObservations','Approve

d',

'Rejected','Cancelle

proposal_attachments




YES


YES

type enum('url','file')

NO

route text

NO


request_students




YES


YES




43

draft_request_id int(10) unsigned MUL YES

research_lines




YES


YES

name_en varchar(191)

NO

name_es varchar(191)

NO

description varchar(191)

NO

role_has_permissions


permission_id int(10) unsigned PRI NO

role_id int(10) unsigned PRI NO

roles



name varchar(191)

NO

guard_name varchar(191)

NO


YES


YES

students_projects




44



YES


YES



universities




YES


YES

name varchar(191)

NO

country_id int(10) unsigned MUL YES

user_research_lines




YES


YES


researh_line_id int(10) unsigned MUL YES

user_studies





45

year smallint(6)

NO

degree_name varchar(191)

NO

university_id int(10) unsigned MUL YES

academic_degree_id int(10) unsigned MUL YES



YES


YES

users



name varchar(191)

NO

last_name varchar(191)

NO

email varchar(191)

NO

password varchar(191)

NO

id_number int(11)

NO

remember_token varchar(191)

YES

avatar varchar(191)

NO user.jpg

personal_info text

YES


YES


YES



46

6.2. Script creación de base de datos

-- Base de datos: `bpapp`

Create database bdapp

6.3. Interfaz inicial del Sistema

Ilustración 38. Interfaz del Sistema



47

6.4. Interfaz Del Administrador

Ilustración 39. Interfaz del administrador



48

7. Cibergrafia.

https://www.apachefriends.org/es/index.html

https://definicion.de/html/

http://www.maestrosdelweb.com/que-son-las-bases-de-datos/

https://www.codementor.io/magarrent/how-to-install-laravel-5-xampp-windows-

du107u9ji

http://php.net/manual/es/intro-whatis.php

https://laravel.com/

https://getcomposer.org/

http://www.anillabs.com/2015/02/how-to-generate-data-dictionary-in-mysql/

http://httpd.apache.org/docs/2.0/es/vhosts/

https://www.apachefriends.org/es/index.html

https://definicion.de/html/

http://www.maestrosdelweb.com/que-son-las-bases-de-datos/

https://www.codementor.io/magarrent/how-to-install-laravel-5-xampp-windows-du107u9ji

https://www.codementor.io/magarrent/how-to-install-laravel-5-xampp-windows-du107u9ji

http://php.net/manual/es/intro-whatis.php

https://laravel.com/

https://getcomposer.org/

http://www.anillabs.com/2015/02/how-to-generate-data-dictionary-in-mysql/

http://httpd.apache.org/docs/2.0/es/vhosts/

MANUAL DE INSTALACIÓN BANCO DE PROYECTOS DE TRABAJO …

Documents

Transcript of MANUAL DE INSTALACIÓN BANCO DE PROYECTOS DE TRABAJO …