Manual de operación (Almacenes)

Manual de operación
Almacenes
GM-Transport

• Documento original
• Video presentación
• Modelo de datos

Fecha: 12 de septiembre de 2024
Versión: Ver. 1.0
Proyecto: GM-Transport

Elaborado por:

Certuit Software S. de R.L de C.V.
Cerro de las Campanas No. 384, Insurgentes Oeste, CP. 21280

Mexicali, BC. México

Historial de Cambios

Fecha	Secciones	Razón de Cambios	Autor(es)	Revisor(es)
12 de septiembre de 2024	TODAS	Creación del documento	Adrian Renteria
13 de septiembre del 2024	TODAS	Actualización del formato	Jocelyn Martinez

Manual de Operación

1. Especificación técnica del sistema

La siguiente documentación técnica describe los requisitos técnicos para desplegar el sistema.

1.1 Especificaciones de hardware

Los requerimientos del servidor se expresan en la siguiente tabla:

Ambiente	Servidor APP	Procesadores	Memoria RAM	Disco duro
Calidad	Maquina virtual	4 CPU	4 GB	50 GB
Producción	Servidor	2 CPU	2 GB	30 GB

Ambiente	Servidor WEBDEV	Procesadores	Memoria RAM	Disco duro
Calidad	Maquina virtual	8 CPU	16 GB	111 GB
Producción	Servidor	32 CPU	8 GB	126 GB

Los accesos para acceder se enlistan en las siguientes tablas:

Ambiente	URL	IP Servidor APP	Usuario	Contraseña
Calidad	http://paqueteria.desarrollo.gmtransport.co:8083	192.168.2.150	administrador	dockerDeploytreegras
Producción	https://almacen.gmtransport.co/	20.64.112.26	GMTUser	Degcj83WeFCRU

Ambiente	IP Servidor WEBDEV	Usuario	Contraseña
Calidad	192.168.2.211	certuitserver	DespE003
Producción	paqueteria-backend.gmtransport.co	GMTAdmin	9Y/Ehx+T]e”{PQ

1.2 Especificaciones de software

El software configurado en el servidor APP se lista en la siguiente tabla:

Software	Descripción
Ubuntu 18.04.6 LTS	Sistema operativo
Apache Tomcat 8	Servidor de aplicaciones Java
Java 18	Máquina virtual de Java

2. Operación del sistema

2.1 Entorno de desarrollo del sistema

Los entornos consisten en lo siguiente:

1. Servicios web

   1. Lenguaje: Java
   2. IDE: IntelliJ IDEA 2021.3.2 (Ultimate Edition)
   3. Framework: Spring boot (2.1.6)
   4. Herramientas: Maven (3.8.1), SDK(1.8)
   5. Configuración del ambiente
      1. Abrir en IDE proyecto principal
      2. Esperar a la descarga de dependencias

2. Aplicación web

   1. Lenguaje: JavaScript
   2. IDE: WebStorm 2021.3 (Ultimate Edition)
   3. Framework: ReactJs (17.0.1)
   4. Herramienta: Node (14.17.3), npm (6.14.13)
   5. Configuración del ambiente
      1. Abrir terminal desde IDE
      2. Ejecutar el comando: npm install

2.2 Generación de empaquetados para despliegue

Para desplegar y facilitar la creación de empaquetados es necesario configurar el ambiente de desarrollo descrito en la sección 1.3.

2.2.1 Servicios web

1. Seleccionar la opción Build > Build Artifacts > All Artifacts

En caso de usar visual seguir la documentación oficial para la creación del empaquetado.

2. Renombrar el war, ubicado en /target, a servicios

2.2.2 Aplicación web

1. Abrir terminal desde IDE
2. Ejecutar el comando: npm run build
3. Renombrar la carpeta generada (build) a ROOT

2.3 Operación de servicios

Ejecutar y/o detener aplicación Web:

1. Acceder por SSH al servidor con Bitvise SSH Client
2. Ingresar
   1. IP: IP del servidor
   2. Puerto: 22
   3. Usuario
   4. Contraseña
3. Abrir la consola e ingresar como root con los comandos (este paso solo aplica para el ambiente de Calidad):
   1. su
   2. Ingresar contraseña de root.
4. Ejecutar el comando correspondiente a la acción y ambiente.

Iniciar
TOMCAT_HOME/bin/startup.sh
Detener
TOMCAT_HOME/bin/shutdown.s

Ambiente	Ruta TOMCAT_HOME
Calidad	/opt/tomcat2/
Producción	/opt/tomcat-2

2.3.1 Desplegar servicios Web

1. Acceder por SFTP al servidor con Bitvise SSH Client
2. Ingresar
   1. IP: IP del servidor
   2. Modo de acceso: Normal
   3. Usuario
   4. Contraseña
3. Arrastrar el archivo war(previamente renombrada) almacen.war a la ruta

Ambiente	Ruta
Calidad	/home/administrador
Producción	/home/GMTUser

4. Acceder por SSH al servidor con Bitvise SSH Client
5. Ingresar
   1. IP: IP del servidor
   2. Puerto: 22
   3. Usuario
   4. Contraseña
6. Abrir la consola e ingresar como root con los comandos (este paso solo aplica para el ambiente de Calidad:
   1. su
   2. Ingresar contraseña de root:
7. Ir a TOMCAT_HOME
8. Eliminar el archivo almacen.war
9. Mover el archivo almacen.war a TOMCAT_HOME/webapps

Ambiente	Ruta TOMCAT_HOME
Calidad	/opt/tomcat2/
Producción	/opt/tomcat-2

2.3.2 Desplegar aplicación Web

1. Acceder por SFTP al servidor con Bitvise SSH Client
2. Ingresar
   1. IP: IP del servidor
   2. Usuario
   3. Contraseña
3. Arrastrar carpeta (previamente renombrada) ROOT a la ruta:

Ambiente	Ruta
Calidad	/home/administrador
Producción	/home/GMTUser

4. Acceder por SSH al servidor con Bitvise SSH Client
5. Ingresar
   1. IP: IP del servidor
   2. Puerto: 22
   3. Usuario
   4. Contraseña
6. Abrir la consola e ingresar como root con los comandos (este paso solo aplica para el ambiente de Calidad:
   1. su
   2. Ingresar contraseña de root:
7. Ir a TOMCAT_HOME/webapps
8. Eliminar la carpeta ROOT
9. Mover la carpeta ROOT a /TOMCAT_HOME/webapps

Ambiente	Ruta TOMCAT_HOME
Calidad	/opt/tomcat2/
Producción	/opt/tomcat-2

2.3.3 Registros de errores

El sistema genera un archivo de errores que podrían ayudar a solucionar problemas, tal como lo es el log que proporciona Tomcat. Puede acceder a él ejecutando los siguientes comandos:

1. Acceder por SSH al servidor con Bitvise SSH Client.
2. Ingresar
   1. IP: IP del servidor
   2. Puerto: 22
   3. Usuario
   4. Contraseña
3. Abrir la consola e ingresar como root con los comandos (este paso solo aplica para el ambiente de Calidad):
   1. su
   2. Ingresar contraseña de root:
4. Ejecutar el comando según el ambiente.

tail -f TOMCAT_HOME/logs/catalina.out

Ambiente	Ruta TOMCAT_HOME
Calidad	/opt/tomcat2/
Producción	/opt/tomcat-2

2.4 Versionamiento

Para el versionamiento de la aplicación se gestionan tres ramas como se indican a continuación:

Develop
Esta rama es la que se toma de base para los nuevos desarrollos o correcciones de bugs. Debe contener solo los cambios aprobados por calidad.

Calidad
Esta rama es la utilizada para realizar despliegues al ambiente de calidad sobre los cambios realizados en las ramas de los desarrolladores.

Master
Esta rama es la utilizada para la liberación al ambiente de producción.

2.5 Creación de base de datos nueva

Para la generación de nuevas bases de datos no se cuenta con una base de datos de referencia, se cuenta con el script para generar la estructura con las tablas del proyecto y se cuenta con el script para la carga de catálogos iniciales. Es importante mantener actualizado el script o generarlo nuevamente una vez realizado un despliegue a producción.