
Documentación técnica V5

En condiciones normales de implementación local utilizando un servidor en red, SG Systems instalará e implementará software y servicios en este servidor según las especificaciones/alcance descritos por el cliente. Esta guía no pretende ser una guía paso a paso a seguir, sino más bien un resumen de las acciones estándar que se tomarán/el software que instalará SG Systems al instalar y configurar una nueva implementación.
Se pueden proporcionar más detalles a pedido.
SG Systems implementará, de forma estándar, la edición Express de SQL Server 2017 , aunque las aplicaciones de SG admiten el uso de varias ediciones y versiones hasta la edición Enterprise 2022, según los requisitos o solicitudes de los clientes para utilizar una versión diferente.
SQL Server Management Studio también se instalará junto con la versión de servidor seleccionada para permitir la administración de la base de datos. Puede ser cualquier versión hasta la última versión (versión 20).
Estas instalaciones seguirán el patrón de instalación estándar 'Básico' cuando ejecutemos el instalador.

Luego se deben aceptar los términos y elegir una ruta de instalación. A menos que el cliente indique lo contrario, esto se instalará en la ubicación predeterminada que se muestra a continuación:

Una vez elegida esta ubicación, se debe seleccionar "Instalar". Luego, el instalador descargará e instalará los datos relevantes.
Al finalizar, se mostrarán diversos datos, como el nombre de la instancia de SQL Server, la versión, la cadena de conexión, etc.
Desde aquí, SG Systems también instalará el software de administración de SQL Server, cuya última versión está disponible a través del botón resaltado que abrirá una página de descarga para la última versión.

Si SSMS ya está instalado o se está instalando desde un instalador independiente, esta ventana ahora se puede cerrar.
SQL Server Management Studio
Al ejecutar el instalador SSMS, SG Systems lo instalará una vez más en la ubicación predeterminada:

Luego se ejecutará este instalador y se mostrará un mensaje de confirmación cuando se complete.

Además de realizar la instalación estándar de SQL Server/Mangement Studio descrita anteriormente, SG Systems también realizará los siguientes cambios en las configuraciones de las aplicaciones para facilitar la funcionalidad con el sistema V5.
Configuración del puerto TCP
SG comenzaría abriendo el 'Administrador de configuración de SQL Server' para la edición relevante del servidor que se instaló.

Una vez abierto y seleccionada la instancia correcta del servidor en el lado izquierdo, se habilitarán todos los protocolos, después de lo cual se hará clic derecho en 'TCP/IP' y se seleccionarán las propiedades.

Aquí los puertos para todos los 'IPAll' se configurarán en 1433. Aquí se pueden usar otros puertos dependiendo de la solicitud del cliente/disponibilidad de puerto.

Luego se reiniciará el servicio SQL Server para aplicar estos cambios.
Estudio de administración de Microsoft SQL Server
Luego, SG realizará los siguientes cambios en MSSMS:
Se seleccionarán las propiedades del servidor:

Y en la pestaña "Seguridad", la autenticación del servidor se configurará en "Autenticación de SQL Server y Windows" y se aplicará la configuración.

A continuación, se editará el usuario 'sa' (que se encuentra en los menús 'Seguridad' > 'Inicios de sesión') (este es el perfil de usuario predeterminado que SG utiliza para iniciar sesión en la base de datos desde el software y puede que no se aplique si se utiliza Active Directory ).

En la pestaña 'General' aquí se ingresará la contraseña predeterminada de SG (disponible a pedido) y se desmarcará 'Aplicar política de contraseñas'.

Y en la pestaña 'Estado', se habilitará el inicio de sesión y se aplicarán los cambios.

Luego se puede cargar una base de datos SG desde una copia de seguridad.
SG Systems utiliza una versión modificada del conjunto de informes Jaspersoft que normalmente también se instala en el servidor del cliente como parte del paquete de software inicial. Los informes SG admiten versiones de este software desde 7.1 a 8.0. Este paquete se ejecuta en un backend de servicio web Apache Tomcat 8.0 en el puerto 8080 para que los usuarios de la red puedan acceder a estos recursos.
Comenzaríamos a instalar los informes web de SG ejecutando TIB_js-jrs-cp_*.exe y seleccionando 'instalación personalizada'.

Seleccione la ubicación de instalación deseada (la ubicación predeterminada se muestra aquí):

Seleccione la opción Tomcat incluida.

Seleccione utilizar la base de datos PostgreSQL incluida.

Seleccione utilizar la opción PhantomJS incluida.

Introduzca los puertos de Tomcat deseados; los predeterminados ya están configurados. Tenga en cuenta que, dependiendo de si el cliente requiere la instalación de la API V5, el puerto aquí especificado podría cambiarse a 8081 o similar, según el orden de instalación. Puede encontrar más información sobre la instalación de la API V5 aquí.

Seleccione el puerto de base de datos deseado, el valor predeterminado es 5433.

No necesitamos los informes de muestra, por lo que podemos seleccionar No aquí.

Aquí encontrará más información sobre el uso posterior de los informes web de SG.
La familia de aplicaciones V5 requiere la instalación de Java Runtime Environment para funcionar y, como tal, Java se instalará en cualquier dispositivo que ejecute una aplicación V5, incluido el servidor.
Un representante de SG podrá recomendarle una versión de Java según la configuración del sistema. Esta será Java 8 o Java 11, y las guías para su instalación se detallarán a continuación.
La versión instalada aquí es Java 64 Update 8 de 144 bits, pero en realidad cualquier versión de Java 8 es compatible. Tenga en cuenta que para las instalaciones de WMS y Control Center, se requiere Java de 64 bits (y, por lo tanto, un sistema operativo de 64 bits). El terminal puede ejecutarse en sistemas de 32 bits.
Al iniciar el instalador nos pedirá que hagamos clic en siguiente:

En la página siguiente, y si utilizamos una versión de Java que incluye el kit de desarrollo de Java (JDK), podemos optar por omitir el elemento 'Código fuente' aquí, ya que solo se requiere Java Runtime Environment (JRE) para ejecutar las aplicaciones V5. .

Luego, el instalador descarga los archivos apropiados y luego tendremos una opción sobre dónde instalar Java. Como de costumbre, SG Systems lo instalará en la ubicación predeterminada que le indique el instalador.

Una vez que se ejecute el instalador desde aquí, el proceso se completará y el instalador se cerrará. Ahora desactivaremos las actualizaciones automáticas de Java:
En el menú de inicio de Windows, busque "Configurar Java" y ábralo:

Haga clic en la pestaña Actualizar > desmarque “Buscar actualizaciones automáticamente” > No marcar > Aceptar. Esto evitará que Java se actualice automáticamente a una versión más reciente que pueda comprometer la funcionalidad de las aplicaciones V5.

Si la casilla de verificación "Buscar actualizaciones..." está atenuada, debe cerrarla y ejecutarla nuevamente, pero esta vez como administrador.
En los casos en que esté instalado Java 11, utilice el instalador suministrado para la versión 26 de Java 11 y ejecútelo.

Después de hacer clic en “Siguiente” aquí, elija una ubicación de instalación (si se requiere una distinta a la predeterminada).

Al hacer clic en "Siguiente", se instalará Java 11 en la ubicación especificada y se completará. Haga clic en "Cerrar" para salir del instalador.

Esa es toda la acción que se requiere aquí, a diferencia de Java 8, no se requieren pasos adicionales.
SG Systems finalmente instalará una selección de aplicaciones V5 en el servidor del cliente. Nuevamente, esto está determinado por el alcance del sistema especificado originalmente. Esto se logra mediante el uso del 'Instalador SG'. Este instalador también se puede utilizar para actualizar aplicaciones en el futuro.
Aquí encontrará una guía sobre el uso del instalador SG.
De forma predeterminada, el instalador de SG creará una carpeta llamada 'Software SG' en 'Archivos de programa (x86) y colocará las carpetas de instalación de aplicaciones aquí.
De esta forma una instalación estándar del Centro de Control SG se instalará en la siguiente ubicación, salvo que el cliente indique lo contrario:
Esto es lo mismo para TODAS las aplicaciones SG, incluidas SG Terminal, SG WMS y SG Data Engine.
Se necesita un paso adicional en todas las instalaciones de SG para garantizar que las aplicaciones de SG puedan escribir en los archivos de configuración dentro de la carpeta de instalación. Haga clic derecho en la carpeta SG Software (ubicada de forma predeterminada en C:\Program Files (x86)\SG Software) y haga clic en Propiedades. Luego, en la pestaña "Seguridad", haga clic en "Editar" y luego en "Agregar":

En la ventana resultante, escriba "Todos" y haga clic en Aceptar.

Finalmente, resalte 'Todos' y marque Control total, antes de hacer clic en Aceptar.

Para conectar la aplicación al servidor, SG Systems utiliza archivos '.properties', que se encuentran en la carpeta 'config' de la instalación de la aplicación SG, y que se pueden abrir y editar usando un lector de texto básico como el Bloc de notas.

El archivo 'db_settings' aquí es el que queremos editar para conectarnos al servidor. El archivo 'app_settings' aquí son las configuraciones de la aplicación, pero se controlan a través de la configuración central en el Centro de control, por lo que no se discutirán aquí.
Al abrir esto se mostrará algo como lo siguiente:

Si está utilizando la autenticación SQL, el nombre de usuario y la contraseña se encuentran en este archivo junto con la cadena de conexión.
Si utiliza Active Directory, la cadena de la base de datos deberá contener “IntegratedSecurity=true;” . El software V5 utilizará entonces sqljdbc_auth para autenticar la conexión a la base de datos mediante la información de la cuenta de Windows.
Si los dispositivos/PC están en un dominio y utilizan SSO, el software V5 se iniciará automáticamente después de que se haya realizado la conexión a la base de datos. No tenemos una solicitud de nombre de usuario y contraseña para ingresar al software V5 porque el usuario ya inició sesión en el dispositivo mediante SSO, por lo que no es necesariamente necesario.
Entonces, cuando se usa AD/SSO con V5, lo principal es asegurarse de que la base de datos SQL comparta el mismo controlador AD que los dispositivos Windows para que la conexión de la base de datos pueda autenticarse utilizando la información de la cuenta de Windows. Estos usuarios también deberán poder actualizar/insertar/eliminar registros de la base de datos.
SG Systems ofrece una integración API completa con una amplia variedad de soluciones ERP que los clientes puedan utilizar. Si esto forma parte del proceso de implementación, la API V5 se instalará junto con otros elementos del sistema de trazabilidad V5.
El proceso que se seguirá se puede encontrar en nuestra Guía de instalación de la API V5.