Manual Instalación (aplicación web) - TeamCloudSolution/QuickOrder GitHub Wiki

Sobre este manual

Introducción

Este manual describe como hacer la instalación del sistema.

Alcance y público

Orientado al personal que realiza la instalación de sistemas y deployment. Abarca los pasos de instalación, condiciones previas y herramientas necesarias.

Historia de cambios

Rev. Fecha Autor Descripción
1.0 15/12/2016 Andrea Carranza Daza Manual de instalación
1.0 15/12/2016 Ely Condori Guevara Manual de instalación

Overview del Sistema

Introducción

Este sistema tiene como objetivo realizar pedidos mediante una carta digital.

Condiciones previas

Antes de la instalación del sistema proceder con la ejecución de la instalación de base de datos PostgresSQL .

Requerimientos previos de Instalación

La siguiente lista muestra los requerimientos mínimos para el correcto funcionamiento del sistema.

  •   4 Gb. de espacio en disco.
  • 4 Gb. De Memoria RAM.
  • Sistema Operativo: Windows 2007.
  • Navegador: Google Chrome.
  •   Servidor Web: JBoss 6.2 EAP.
  • Base de Datos: PostgreSQL 9.0 en adelante.
  •   JDK (java 1.6 o java 1.7)

Instalación del Sistema

Instalación de PostgreSQL

  • Si no cuenta con este Gestor de Base de Datos puede ingresar al siguiente enlace para descargarlo: PostgreSQL

Pasos previos a la instalación

  •   Crear la BD en PostgreSQL con el nombre "heladeria_bambi"

  •   Instalar la base de datos, puede descargar la base de datos del siguiente enlace: [[Descargar Script aquí](https://github.com/TeamCloudSolution/QuickOrder/tree/script)]<!--(https://goo.gl/l2RGGg) -->

  •   Realizar la instalación de JBoss 6.0 EAP en la máquina donde se instalará el sistema.

Instalación del JBoss

  • Para la descarga del servidor JBoss 6.2 ingresamos al siguiente enlace : [Descargar JBoss-eap_6.2.zip aquí] (https://www.dropbox.com/s/920991rav9xv76p/jbosseap_6.2.zip?dl=0) (Actualmente en la pagina oficial se puede encontrar la version 7 JBoss, esta presenta diferencias con la que estamos trabajando).
  • Una vez realizada la descarga tenemos que definir la ruta donde queremos almacenar nuestro servidor.
  • Descomprimimos el archivo en el directorio que vamos a usar como referencia. (lo mas recomendable descomprimir en la raíz del C:/)

Despliegue del Servidor

  • Ingrese a la consola de Windows al directorio de JBoss/bin/
  • Ejecutar standalone.bat Al hacer esto, se ejecuta la consola del server donde veremos todos los logs que se empiezan a generar, informándonos del proceso de despliegue, aquí veremos como todo se ejecuta correctamente o si existen errores.
  • En estos momentos con el servidor arriba, podemos verificar la pagina de administración del JBoss, para eso ingresamos en un navegador al http://localhost:8080 (8080 es el puerto por defecto del servidor, si queremos puede ser modificado)
  • Como vemos se carga la página de administración del servidor, allí encontramos diferentes enlaces útiles como wikis, foros, documentación entre otros.

Agregar un usuario

  • Para finalizar el despliegue del servidor, volvemos a la consola del JBoss y simplemente damos un Ctrl+C (Aunque también podemos cerrar la ventana, pero tal vez en ocasiones queden procesos activos)
  • Vemos como se nos pregunta si deseamos terminar con el proceso, indicamos s y la consola se cierra, y con ello los procesos que estemos ejecutando.
  • Ejecutar add-user.bat
  • Seleccionar la opción (a)
  • Ingresar usuario y contraseña

  • Presionar enter
  • Confirmar la creación del usuario presionando 'y' y luego confirmar los roles presionado nuevamente'y'
  • Para finalizar la creación de usuario presione cualquier letra
  • Se inicia el JBoss ejecutando standalone.bat
  • Ingresar http://localhost:9990/console pedira usuario y contraseña ingresar al usuario que crearon

Creación de datasources en JBoss 6.2 EAP

Esta conexión es necesario para acceso a la base de datos propia del sistema

Iniciamos el servidor de JBoss 6.2 EAP por medio de la consola de comandos y ejecutando el archivo standalone.sh del directorio ..../bin. Una vez iniciado, ingresamos a la consola administrativa por medio del browser que tengamos instalado. Abriendo la consola de administración de Jboss https://IP_SERVER:PUERTO_SERVER/console. Donde la dirección de IP usada, es la IP del servidor donde está instalado JBoss 6.2 EAP el puerto es el designado al protocolo http, que por defecto es 8080 si no se ha modificado la configuración del servidor web.

Seleccionar Administration Console

Ingresar la cuenta para administrar JBoss.

Seleccionar “Profile” en la pantalla superior derecha y luego en el submenú izquierdo de la pantalla seleccionar “Datasources” y para adicionar un nuevo datasource seleccionar “Add”.

  • Name: nombre del Datasource, para este caso será “bambi”.
  • JNDI Name: nombre del JNDI, inicia con “java:/” seguido del nombre del Datasource, para este caso sería: “java:/bambi”.

Seleccionar el driver JDBC que luego de haber sido instalado debe ser como el de la imagen.

Connection URL: La url de conexión que debería ser la ip del servidor donde se encuentra la Base de datos, el puerto de conexión a la BD y el nombre de la BD.Ejemplo: jdbc:postgresql://127.0.0.1:5432/heladeria_bambi

Username: Nombre del usuario para la conexión a PostgreSQL. Password: Contraseña de la cuenta para la conexión a la base de datos Para terminar click en “Done”.

Seleccionar de la lista de Datasources el nuevo Datasource creado y lo habilitamos con el botón “Enable” de la parte superior derecha de la pantalla.

Confirmar la ventana de confirmación.

Probando conexión a la base de datos

  • Seleccionar el datasource creado,click en la pestaña conection y click en el boton test conection
  • Se desplegara un mensaje de conexión exitosa

Descargar HeladeriaBambiweb.war de github Proyecto

Copiar el archivo war al directorio de JBoss /standalone/deployments Aparecerá automáticamente otro archivo con el mismo nombre y un subfijo".deployed"

Para probar que el sistema funciona correctamente ingresar a la URL http://localhost:8080/HeladeriaBambiWeb/