Instalación manual - Windows

Esta página describe el proceso de instalación manual de la solución Navixy On-premise en Windows. Recomendamos usar Windows Server 2016 o posterior. Si desea instalar la plataforma en cualquier otra versión de Windows, por ejemplo versiones de escritorio, aún puede aplicar esta guía, ya que los principios básicos y el software son los mismos. Sin embargo, solo las versiones Server se consideran una solución confiable.

La instalación totalmente manual de Navixy-On-premise para Windows se proporciona para clientes que necesitan control total sobre el proceso de instalación o que tienen requisitos de configuración personalizados. En general, se recomienda realizar una instalación automatizada en Linux, ya que es mucho más fácil y flexible no solo para la instalación inicial, sino también para la administración y el mantenimiento futuros. Las instrucciones de instalación en Windows están disponibles para aquellos clientes que se centran en usar este SO exclusivamente debido a requisitos corporativos u otras razones internas.

Aunque la plataforma utiliza el mismo software de terceros tanto en Linux como en Windows, la principal diferencia en su funcionamiento es cómo se ejecutan los servicios en Windows:

• Los servicios Java se convierten en servicios de Windows usando el software YAJSW.

• Nginx no es un servicio sino un programa normal que se ejecuta en segundo plano.

Para realizar la instalación, necesita una cuenta de Windows con privilegios de administrador. No importa si es una cuenta local o de dominio porque la plataforma no está relacionada con la infraestructura de dominio de ninguna manera. Solo necesita derechos suficientes para instalarla.

Instalar el software prerequisito

Descargue e instale los prerrequisitos descritos en Software del servidor documento. Esencialmente, necesitará estos componentes para poner la plataforma en funcionamiento:

• MySQL 8.0 - solo Server es obligatorio, los demás componentes son opcionales;

  • Microsoft Visual C++ puede ser requerido para la instalación. El asistente de instalación le notificará al respecto.

• Java SE Development Kit 21;

• Nginx - cualquier versión reciente (no necesita instalación, solo extraerla);

Además de los componentes básicos, también se recomienda instalar el siguiente software para facilitar el trabajo posterior:

• Cualquier descompresor capaz de extraer archivos tar.gz - por ejemplo 7-Zip.

• Editor de texto avanzado para trabajar con configuraciones y archivos de registro grandes - por ejemplo Notepad++.

Se recomienda encarecidamente instalar el software de terceros solo desde recursos oficiales - preferiblemente desde los enlaces anteriores. Si el software se instala desde recursos no fiables, no se garantiza su operatividad.

Configuración de MySQL

Después de instalar MySQL Server, necesita aplicar cambios a su configuración para que la plataforma Navixy funcione correctamente con la base de datos. La configuración se especifica en my.ini archivo ubicado en la siguiente ruta:

C:\ProgramData\MySQL\MySQL Server 8.0\my.ini

En este archivo debe establecer los parámetros que se indican a continuación bajo la [mysqld] sección. Si ya están presentes, cámbielos en consecuencia.

default-time-zone='+00:00'
sql-mode="NO_ENGINE_SUBSTITUTION"
innodb_buffer_pool_size=10G

El innodb_buffer_pool_size este parámetro es la cantidad de RAM asignada para MySQL. Se recomienda encarecidamente establecer este parámetro en 70% de la RAM total en su servidor (en gigabytes).

Después de cambiar la configuración, guarde el archivo y reinicie MySQL desde el complemento Servicios de Windows (services.msc) para aplicar los cambios.

Variables de entorno

Java y MySQL bin las carpetas deben especificarse en la variable de entorno del sistema Windows PATH Estas carpetas son (por defecto) las siguientes:

• C:\Program Files\Java\jdk-21\bin

• C:\Program Files\MySQL\MySQL Server 8.0\bin

La carpeta de instalación de Java también debe agregarse a la nueva variable del sistema JAVA_HOME Esto es necesario para que los servicios de backend funcionen correctamente

Los nombres de las carpetas pueden variar de una versión a otra, así que compruebe primero las rutas reales.

Puede actualizar las variables de entorno con los siguientes comandos desde la línea de comandos:

setx /m Path "%PATH%;C:\Program Files\Java\jdk-21\bin;C:\Program Files\MySQL\MySQL Server 8.0\bin"
setx /m JAVA_HOME "C:\Program Files\Java\jdk-21"

Esto creará los valores requeridos.

También puede actualizar las variables de Path y JAVA_HOME manualmente en las propiedades del sistema.

Como resultado, debe tener lo siguiente:

Variables de entorno

Después de guardar las variables, abra la línea de comandos y compruebe las versiones del software con los siguientes comandos:

mysql -V
java -version

Si se devuelven las versiones, entonces las variables están configuradas correctamente.

Versiones de software

Si ve errores como no se reconoce como un comando interno o externo, compruebe las rutas que especificó antes.

Desempaquetar la plataforma

El paquete de distribución de Navixy se proporciona como un archivo .tar.gz. La versión más reciente siempre está disponible para descargar en el siguiente enlace:

⬇️ Descargar el paquete Navixy On-premise

Colóquelo en cualquier carpeta de su servidor y extráigalo.

El paquete tiene muchas carpetas anidadas, así que tenga cuidado de no exceder el límite de Windows de 255 caracteres en la ruta de archivo.

Coloque la carpeta navixy-package del archivo en algún directorio como: C:\distrib\navixy-package

En adelante, esta será la carpeta principal de la distribución. Más adelante en esta instrucción puede encontrar rutas como ...navixy-package/db, lo que significa que las operaciones deben realizarse desde esta carpeta y sus subcarpetas.

Después de desempaquetar la plataforma y preparar todos los prerrequisitos, está listo para comenzar la instalación de la plataforma Navixy.

Bases de datos Navixy

Primero, debe realizar la configuración de la base de datos MySQL. Se recomienda trabajar con MySQL desde la línea de comandos. Conéctese a MySQL como root usuario con la contraseña que estableció durante la instalación de MySQL:

mysql -uroot -p

Ejecute el bloque de consultas a continuación. Sustituya <PASSWORD> por una nueva contraseña para navixy usuario, recuérdela, la necesitará más adelante.

CREATE USER navixy@'%' IDENTIFIED BY '<PASSWORD>' WITH MAX_QUERIES_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_USER_CONNECTIONS 0;
CREATE DATABASE google CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE DATABASE tracking CHARACTER SET utf8 COLLATE utf8_general_ci;
GRANT USAGE ON *.* to navixy@'%';
GRANT ALL PRIVILEGES ON google.* TO navixy@'%';
GRANT ALL PRIVILEGES ON tracking.* TO navixy@'%';

Esto creará bases de datos vacías para su uso posterior.

Salga de MySQL y vuelva a la línea de comandos.

Contenido de la base de datos

Cambie el directorio en la línea de comandos a ...navixy-package\db.

Ejecute el siguiente comando para importar la estructura de las tablas de datos comerciales:

mysql -uroot -p google < google.sql

Después de eso, elimine los updates.sql y google.sql archivos con los siguientes comandos, ya que no son necesarios en el siguiente paso:

del updates.sql
del google.sql

Ahora importe los archivos restantes en la base de datos usando este comando:

type *.sql | mysql -uroot -p google

Servidor de archivos

Conéctese a MySQL nuevamente y ejecute la siguiente consulta SQL. Esto permitirá subir archivos desde la aplicación móvil y la interfaz web a su servidor, lo cual es necesario al trabajar con formularios de servicio de campo, mantenimiento de vehículos y otras funciones. Cambie api.domain.com a su dominio para API, y cambie https a http si no usa SSL.

INSERT INTO google.file_storages (id, engine, config) values (1, 'local_fs', '{"base_path":"./files/","base_upload_url":"https://api.domain.com/file/upload","base_download_url":"https://api.domain.com/file/dl","secret":"s3cCr3Et","upload_credentials_ttl":"10m","is_dynamic_preview_enabled": true,"dynamic_preview_pattern":"(.+)/file/dl/(.+)","dynamic_preview_replace":"$1/file/preview/$2","security_module":{"type":"hashid","salt":"S4lTh45hV4lu3","ttl":"7d","min_length":8}}');

Se recomienda que los valores de secret y salt sean un hash aleatorio de letras y números.

Clave de licencia

Finalmente, aplique la clave de licencia (huella), que debe ser proporcionada por Navixy. Tiene el aspecto de una cadena larga de símbolos aleatorios.

Inserte la huella en la base de datos con la consulta a continuación. Cambie <FINGERPRINT> por el valor recibido):

UPDATE google.variables SET value='<FINGERPRINT>' WHERE var='fingerprint';

La huella es dinámica. Se actualiza cada vez que su servidor se conecta al auth.navixy.com servidor de licencias. Esto ocurre cada 3 días y en cada inicio de servicio. Por lo tanto, no necesita almacenarla por separado de la plataforma ya que está cambiando constantemente. También por esta razón no puede usarla en múltiples instancias. La clave solo puede ser usada para una única instancia de Navixy On-premise.

Frontend

El siguiente paso es configurar el frontend de la plataforma Navixy On-premise: configurar el servidor web Nginx y los archivos estáticos de la interfaz de usuario.

Create nginx carpeta en el disco C:.

md nginx

Copie la distribución de Nginx desempaquetada a la C:\nginx.

carpeta Nginx

Archivos estáticos

Cree una carpeta llamada www en C:\nginxCopie las carpetas panel-v2 y pro-ui desde navixy-package en ella. Estas son las carpetas que contienen los archivos estáticos del sitio web de Navixy - en realidad, todo su contenido visible. Ahora necesita renombrar los archivos de configuración:

• Abra \panel-v2 carpeta y renombre el archivo PConfig.example.sa.js a PConfig.js.

• Abra \pro-ui y renombre Config.example.sa.js a Config.js.

• Abra \pro-ui\static y renombre app_config.example.sa.js a app_config.js.

En todos los pasos anteriores, simplemente elimine .example.sa de los nombres de archivo. Tenga cuidado de no confundir archivos con nombres similares en las carpetas.

Nginx

Agregue las siguientes líneas al http bloque de C:\nginx\conf\nginx.conf archivo:

include conf.d/*.conf;
server_names_hash_bucket_size 64;

Copie una carpeta llamada include desde ...navixy-package\windows\nginx a C:\nginx\conf carpeta.

Cree una carpeta llamada conf.d en C:\nginx\conf. Esta carpeta contendrá la configuración del sitio web de la plataforma.

Copie estos archivos desde ...navixy-package\windows\nginx al recién creado C:\nginx\conf\conf.d carpeta:

• map.conf

• navixy.conf

Si va a usar protección SSL en su servidor, de modo que su sitio web se abra vía HTTPS, también copie este archivo:

• navixy_ssl.conf

Ahora, configure navixy.conf y navixy_ssl.conf de acuerdo con la Configuraciones de Nginx página. Estos son los principales archivos de configuración para el servidor web, así que tenga especial cuidado al editarlos.

Para configurar la plataforma para que funcione a través de HTTPS, necesitará un certificado SSL válido emitido para su dominio, junto con su clave privada. En ausencia del certificado y su clave privada correspondiente, el servidor web con la opción “443 ssl” no podrá ejecutarse. Para obtener más información sobre los certificados SSL y su funcionamiento en la plataforma, consulte Instalación de certificados SSL página.

Después de que todo lo anterior esté hecho - ejecute nginx.exe como administrador. Asegúrese de que esté en funcionamiento en el Administrador de tareas (normalmente tiene dos o más procesos). Si deja de funcionar, revise C:\nginx\logs\error.log en busca de errores y actúe en consecuencia.

Nginx en ejecución

Backend

Esta parte consta de dos pasos: configurar los servicios Java y convertirlos en servicios de Windows.

Servicios Java - preconfiguración

Create java carpeta en el disco C:.

md java

Copie las siguientes carpetas desde ...navixy-package a C:\java:

• api-server

• sms-server

• tcp-server

En cada una de estas carpetas, mueva la conf subcarpeta desde el subdirectorio dist a la carpeta del servicio. Use los siguientes comandos en la línea de comandos para facilitar esto.

move C:\java\api-server\dist\conf C:\java\api-server\
move C:\java\sms-server\dist\conf C:\java\sms-server\
move C:\java\tcp-server\dist\conf C:\java\tcp-server\

Abra cada una de las tres conf subcarpetas una por una y encuentre db.properties archivos en su interior. Estos son los archivos para configurar los servicios de la plataforma para conectarse a la base de datos. Para asegurar el correcto funcionamiento de cada servicio, necesita actualizar las credenciales de conexión a la base de datos para cada uno de ellos. Edite las siguientes líneas en los archivos de configuración (<PASSWORD> se refiere a la contraseña que creó previamente para el usuario "navixy")

db.username=navixy
db.password=<PASSWORD>

Si su base de datos está alojada en un servidor separado, también debe cambiar la línea db.connectionString en los mismos archivos. Especifique la dirección real de su servidor de base de datos en lugar de localhostpero no cambie nada más en esta cadena.

Servicios Java - API-server

Abra el archivo C:\java\api-server\conf\config.properties.

Edite las siguientes líneas:

• api.externalBaseUrl= - URL de su dominio API (con http:// o https:// al principio). i

• feedback.toEmail=test@localhost - dirección para recibir solicitudes de feedback/ayuda de los usuarios.

• feedback.defaultFromEmail=do-not-reply@localhsot - remitente predeterminado de los correos de ayuda.

• feedback.substituteFromEmail=false - alterna si los mensajes de ayuda se envían desde el remitente predeterminado (false) o desde la dirección de correo personal del usuario (true).

Si no tiene un dominio dedicado para la API, su dominio base se especifica aquí con /api adjunto, p. ej.: https://my.domain.com/api

Servicios Java - SMS-server

Este servicio no requiere configuración y utiliza la configuración predeterminada.

Servicios Java - TCP-server

Abra el archivo C:\java\tcp-server\conf\config.properties.

Edite las siguientes líneas:

• externalIP=127.0.0.1 - especifique la dirección IP de su interfaz de usuario en lugar de 127.0.0.1.

• externalHostname=myhost.ru - especifique el dominio de su interfaz de usuario en lugar de myhost.ru.

La configuración anterior se utilizará para la activación automática de dispositivos.

Servicios Java - conversión a servicios de Windows

En esta etapa se utiliza software de terceros: se llama YAJSW (Yet Another Java Service Wrapper). Este es un software gratuito que se usa para ejecutar aplicaciones Java como servicios de Windows. Se puede encontrar más información en la página web del proyecto. El software en sí está incluido en el paquete Navixy.

Copie la carpeta llamada wrapper desde ...navixy-package\windows a C:\java.

Ejecute la línea de comandos como administrador y cambie el directorio al siguiente:

cd C:\java\wrapper\bat

Ejecute setenv.bat desde este directorio en la línea de comandos.

setenv.bat

Ejecute los siguientes comandos, uno por uno:

wrapper.bat -i ../conf/wrapper.api-server.conf
wrapper.bat -i ../conf/wrapper.sms-server.conf
wrapper.bat -i ../conf/wrapper.tcp-server.conf

Esto instalará los servicios Java de la plataforma como servicios regulares de Windows.

Abra el archivo "Servicios" complemento. Puede buscarlo en el menú inicio, o simplemente ejecute lo siguiente en cmd:

services.msc

Desplácese por la lista de servicios y encuentre los servicios Navixy recién instalados. Inícielos uno por uno.

• Navixy api-server

• Navixy sms-server

• Navixy tcp-server

Servicios de Windows de Navixy

Asegúrese de que los servicios sigan funcionando con el tiempo: deben tener constantemente el estado “Running”. Si alguno de ellos falla, revise sus registros en busca de errores posibles.

Pasos finales

Acceso al panel de administrador

Una vez que todo esté instalado e iniciado, debe comprobar la disponibilidad del dominio de su panel de administrador en su navegador. Cuando lo especifique en la línea de dirección, debería ser dirigido a la página de inicio de sesión. Si el dominio no le dirige a la página correcta, verifique nuevamente la configuración de su servidor web para asegurarse de que sea correcta.

Considere cambiar su contraseña del panel de administrador tan pronto como inicie sesión en el sistema, ya que las credenciales son predeterminadas:

• nombre de usuario: admin

• contraseña: admin

Acceso a la interfaz de Usuario

Para que la interfaz de usuario esté disponible, primero necesita especificar su dominio en el panel de Administración → Service Preferences, tal como se describe en este documento: Nombre de dominio.

Si lo anterior no se realiza, la interfaz de usuario no podrá abrirse.

Actualizaciones

Para actualizar Navixy desplegado en un sistema Windows a la versión más reciente, por favor consulte este documento: Update on Windows

Solución de problemas

Si encuentra algún problema durante el proceso de instalación o configuración, por favor consulte las páginas de Solución de problemas para posibles soluciones.