Getting Started.es - jjaroztegi/BuildingSignalSimulator GitHub Wiki

Primeros Pasos

🇬🇧 View in English

Esta guía te ayudará a configurar y ejecutar el Simulador de Distribución de Señal en tu sistema.

Requisitos Previos

Configuración Manual

  • Java JDK 1.8.0_131
  • Apache Tomcat 9.0.89
  • Base de datos MS Access
  • Navegador web con JavaScript habilitado

Configuración Docker

  • Docker
  • Docker Compose
  • Navegador web con JavaScript habilitado

Instalación

Opción 1: Configuración Manual (Entorno Windows Universidad)

  1. Clonar el repositorio:

    git clone https://github.com/yourusername/BuildingSignalSimulator.git
cd BuildingSignalSimulator

  2. Ejecutar el script de compilación:

    build_uni.bat

    Este script maneja:

    • Configuración de variables de entorno
    • Compilación de Java
    • Despliegue en Tomcat

  3. Acceder a la aplicación en: http://localhost:8082/BuildingSignalSimulator

Opción 2: Configuración Manual (Entorno Linux/Mac)

  1. Clonar el repositorio:

    git clone https://github.com/yourusername/BuildingSignalSimulator.git
cd BuildingSignalSimulator

  2. Asegurarse de que Java y Tomcat estén instalados y JAVA_HOME esté configurado

  3. Modificar el script build.sh para establecer la ruta correcta de TOMCAT_WEBAPPS

  4. Hacer el script de compilación ejecutable y ejecutarlo:

    chmod +x build.sh
./build.sh

    Este script maneja:

    • Compilación de Java
    • Compilación con compatibilidad Java 8 y migración a Jakarta EE
    • Despliegue en Tomcat

  5. Acceder a la aplicación en: http://localhost:8080/BuildingSignalSimulator

Opción 3: Configuración Docker

  1. Clonar el repositorio:

    git clone https://github.com/yourusername/BuildingSignalSimulator.git
cd BuildingSignalSimulator

  2. Construir y arrancar el contenedor:

    docker compose up -d

  3. Acceder a la aplicación en: http://localhost:1313/BuildingSignalSimulator

Guía de Inicio Rápido

  1. Crear una Nueva Configuración

    • Navegar a la pestaña "Configuración"
    • Ingresar detalles del edificio (nombre, número de pisos, nivel de cabecera)
    • Hacer clic en "Guardar Configuración"

  2. Agregar Componentes

    • Ir a la pestaña "Componentes"
    • Seleccionar tipo de componente (Cable Coaxial, Base de Toma, Derivador, Distribuidor)
    • Agregar los componentes necesarios para tu configuración

  3. Ejecutar Simulación

    • Cambiar a la pestaña "Simulación"
    • Organizar componentes para cada piso
    • Hacer clic en "Calcular" para ejecutar la simulación

  4. Ver Resultados

    • Revisar la pestaña "Resultados"
    • Examinar niveles de señal para cada piso
    • Verificar que los niveles estén dentro de los márgenes aceptables (codificados por color)
    • Revisar costo total y sugerencias de optimización

Solución de Problemas

Problemas Comunes

  1. Problemas de Conexión a Base de Datos

    • Verificar ubicación del archivo de base de datos MS Access
    • Revisar configuración de conexión a base de datos
    • Asegurar que el driver JDBC apropiado esté disponible

  2. Problemas de Despliegue en Tomcat

    • Verificar versión de Tomcat (debe ser 9.0.89)
    • Revisar logs de Tomcat para errores
    • Asegurar permisos correctos en el directorio de despliegue

  3. Errores de Script de Compilación

    • Verificar versión de Java (debe ser 1.8.0_131)
    • Revisar variable de entorno JAVA_HOME
    • Asegurar que todas las dependencias requeridas estén disponibles

Obtener Ayuda

Si encuentras problemas no cubiertos aquí:

  1. Revisar la sección de Issues
  2. Revisar logs de error en el directorio logs/
  3. Crear un nuevo issue con información detallada del problema

Siguientes Pasos