Instalación GT en Servidor

Antes de empezar es necesario obtener el link descarga del instalador y disponer de una conexión a internet desde el servidor donde se instalará la aplicación. A continuación, seguir las instrucciones:

1. Requisitos previos y recomendaciones
   1. Instalación SQL Server Express
   2. Instalación Microsoft SQL Server Management Studio
   3. Crear un usuario SQL en SSMS y activar la autenticación mixta
   4. Configuración SQL Server
2. Instalación GT
   1. Explicación de las opciones del instalador GT
   2. Lista de últimas versiones
3. Verificación
4. Resolución de problemas durante la instalación
5. Copias de seguridad y traslado del servidor
6. Actualización de versión
7. Desinstalación completa de Gestión del Tiempo

Importante: Para instalaciones en doble servidor, revisar este procedimiento.

1. Requisitos previos y recomendaciones

Requisitos previos:

• Tener preinstalado el sistema operativo Windows Server 2012 R2 o superior.
• Tener al menos 4GB de memoria RAM y 2 CPUs.

Recomendaciones:

• Se recomienda disponer del navegador Google Chrome preinstalado en el servidor.
• Si la misma máquina se va a compartir con a3Equipo se necesitarán 8GB de memoria RAM. Además, es aconsejable limitar la memoria utilizada por SQL Server a 1GB de RAM si también está instalado en este mismo ordenador.

Para poder instalarnos el programa de Gestión del Tiempo (GT), previamente debemos tener instalados los siguientes programas:

• SQL Server: es un sistema de gestión de base de datos relacionales desarrollado por Microsoft. Debemos tener disponible el programa 2014 o superior. En el apartado 1.1. Instalación SQL Server Express te explicamos cómo instalarlo. También es posible utilizar un SQL ya existente según se explica en el último apartado.
• SQL Server Management Studio (SSMS): se utiliza para crear o administrar objetos de base de datos, configurar la seguridad y escribir consultas Transact-SQL. En el apartado 1.2. Instalación Microsoft SQL Server Management Studio te explicamos cómo instalarlo.

¡Atención! No es posible utilizar este instalador GT para utilizar un servidor de SQL Server remoto.

1.1. Instalación SQL Server Express

Podemos descargarnos el programa SQL Server Express desde el propio instalador de GT o directamente desde la web de Microsoft.

• Instalación SQL Server Express desde el propio instalador de GT

Para ello debemos tener descargado el instalador de GT (explicado en el apartado 2. Instalación GT). Presionaremos el botón SQL Express de la pantalla del instalador de GT:

• Instalación SQL Server Express desde la web de Microsoft

https://www.microsoft.com/es-es/sql-server/sql-server-downloads Descargaremos la versión gratuita Express:

En ambos casos, una vez descargado el archivo lo ejecutaremos y llegaremos al asistente de instalación de SQL. El asistente nos pedirá seleccionar un tipo de instalación. Seleccionamos la instalación Básica.

En la siguiente pantalla especificaremos la ubicación de la instalación, que ya aparece por defecto informada, y presionaremos el botón Instalar.

Una vez instalado, el asistente nos informará de que la instalación se ha completado correctamente. En la pantalla se visualizarán:

• Nombre de instancia: es la instancia de SQL Server que tendremos que introducir más adelante en la pantalla principal del instalador de GT (campo “Seleccione la instancia local de SQL Server”). Explicado en el apartado Explicación de las opciones del instalador GT.
• Administradores de SQL: es el usuario Windows (administrador) que deberemos introducir más adelante en la pantalla principal del instalador de GT. Explicado en el apartado Explicación de las opciones del instalador GT.
• Características instaladas
• Versión
• Rutas de carpetas de instalación

1.2. Instalación Microsoft SQL Server Management Studio

Se recomienda que el ordenador local donde se ejecuta el instalador de GT tenga SSMS instalado. 

En este apartado explicaremos cómo descargar e instalar SSMS. En caso de no tenerlo instalado, podemos descargarlo directamente de la web de Microsoft:

https://docs.microsoft.com/es-es/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-2017

Si previamente hemos instalado el SQL Server, el mismo instalador SQL Server nos permite instalar el SSMS mediante el botón Instalar SSMS, el cual nos abrirá la web de Microsoft.

Desde la web de Microsoft hacemos clic en descargar:

Una vez descargado el archivo lo ejecutamos. Se abrirá la pantalla del asistente de instalación y presionaremos Install:

Si la instalación se ha realizado correctamente, aparecerá una pantalla como la siguiente:

1.3. Crear un usuario SQL en SSMS y activar la autenticación mixta

1. Abrimos el Microsoft SQL Server Management Studio y nos conectamos. Si es la primera vez que inicias sesión en SSMS, tendrás que utilizar tu usuario de Windows. En la pantalla de conexión SQL Server (Connect to Server), seleccionaremos la opción Windows Authentication del desplegable Authentication. Presionaremos Connect.

2. Una vez conectados, ya podremos crear un usuario SQL. Desplegamos la carpeta Security de la columna de la izquierda y clicamos sobre Logins con el botón derecho del ratón. Seleccionamos New Login y se abre la siguiente ventana:

3. En la ventana Login – New –> General informaremos:

• Login name: introduciremos el nombre del nuevo usuario SQL.
• Seleccionaremos la opción SQL Server authentication.
• Password y Confirm password: introduciremos una contraseña para el nuevo usuario SQL y la confirmaremos.
• Checkbox Enforce password policy: esta casilla valida si la contraseña introducida cumple los requisitos de complejidad. Para ser una contraseña segura tiene que contener mayúsculas, minúsculas, números, caracteres no alfanuméricos y no ser demasiado corta. Se recomienda mantener la casilla seleccionada. En el caso de introducir una contraseña no compleja, tendremos que desmarcar esta casilla. Si no lo hacemos, nos aparecerá el siguiente mensaje de error.

• Checkboxes Enforce password expiration y User must change password at next login: desactivamos las dos opciones para evitar que expire la contraseña y que nos pida cambiar la contraseña cuando iniciemos la próxima sesión con este nuevo usuario.

4. En la ventana Login – New –> Server Roles seleccionaremos el rol sysadmin, tal y como se muestra en la siguiente imagen:

5. Una vez informados todos los datos presionaremos OK y se creará el nuevo usuario SQL.
6. Para activar la Autenticación mixta pulsamos el botón derecho del ratón encima del nombre de nuestra instancia SQL, Properties –> Security, y seleccionamos la opción SQL Server and Windows Authentication mode.

7. Reiniciamos el servidor SQL: pulsamos el botón derecho del ratón encima del nombre de nuestra instancia SQL y clicamos en Restart.

8. Comprobamos que podemos iniciar sesión con el nuevo usuario SQL. Para ello, desconectamos la sesión (clicar en icono “Disconnect” ) y seguidamente volvemos a conectarnos (clicar en icono “Connect Object Explorer”).

1.4. Configuración SQL Server

1. Abrimos el SQL Server Configuration Manager.
2. Entramos en el apartado Configuración de red de SQL Server –> Protocolos de SQLEXPRESS. Nos aseguramos de que tenemos habilitadas las opciones Memoria compartida y TCP/IP, en caso de que no estén habilitadas las habilitamos con el botón derecho del ratón y clicamos en habilitar

3. A continuación, entramos en el apartado Servicios de SQL Server y nos aseguramos de que el SQL Server (SQLEXPRESS) y el SQL Server Browser cumplan lo siguiente:

• Estado = En ejecución. Si está detenido, cambiaremos el estado con el botón derecho del ratón y lo iniciaremos.
• Modo de inicio = Automático. Pulsamos el botón derecho del ratón y clicamos en Propiedades: Servicio –> Modo de inicio, seleccionamos Automático y presionamos Aceptar.

2. Instalación GT

Nota: Si la misma máquina se va a compartir con otro software previamente instalado, se recomienda realizar una copia de seguridad de todo antes de iniciar la instalación.

Se recomienda realizar una copia de seguridad según el procedimiento del apartado 5 (Copias de seguridad y traslado del servidor) antes de ejecutar el instalador si ya existe una versión de la aplicación GT anterior.

• Obtenemos el último instalador GT del fichero ServerInstaller.exe (te lo facilitará tu proveedor).
• Tras la descarga descomprimimos el fichero 7z. Solicitará una contraseña. Copiamos el fichero en una carpeta local y lo ejecutamos. Nota: si no dispones de un descompresor, puedes pedir a tu proveedor una versión del descompresor 7z.
• Rellenamos los campos del instalador GT. Ver detalles en el siguiente apartado Explicación de las opciones del instalador GT.
• Seleccionamos Instalar.

Explicación de las opciones del instalador GT

Para poder empezar con la instalación de Gestión del Tiempo, informaremos todos los campos que se visualizan en la pantalla principal del instalador. La pantalla presenta el siguiente aspecto:

• Seleccione la instancia local de SQL Server: Introduciremos el nombre de instancia informado en el asistente de instalación del SQL Server Express. Este dato lo hemos obtenido en pasos anteriores, al instalar el SQL Server. Está explicado en el apartado 1.1. Instalación SQL Server Express. Ejemplo: (local)\SQLEXPRESS –> nuestra instancia local se llama SQLEXPRESS.
• Usuario SQL + Password usuario SQL: Añadiremos nuestro usuario SQL con su contraseña. ¡Importante! Debe ser un usuario administrador de la base de datos con el rol sysadmin.
• Usuario Windows (administrador) + Password: Nos permite crear un usuario de Windows con permisos de administración, que se usará para configurar los servicios de la aplicación. No olvides anotar estas credenciales en algún lugar seguro. También nos permite reutilizar un usuario de Windows existente. En este caso, si reutilizamos un usuario existente y si el usuario es de dominio, informaremos el nombre completo, indicando el domino y el usuario. Ejemplo: si el usuario es martin y el dominio es PRO, introduciremos PRO\martin.
• Botón “Configuración avanzada”: Nos permite acceder a la configuración avanzada del instalador. Solo para usuarios experimentados, se recomienda no modificar ningún dato de la pantalla. La pantalla de Configuración avanzada tiene el siguiente aspecto:

– Módulo URL rewrite para IIS: es una extensión de IIS para gestionar las direcciones URL de forma especial.

– Node.js + iisnode para IIS: software de base de la aplicación.

– Descompresor 7z: software auxiliar.

Instalar base de datos:

Permite escoger entre instalar una base de datos de tipo demo, que incluye un conjunto de datos de demostración del programa, o bien una base de datos vacía si se va a instalar el programa en un cliente final.

Directorio para las bases de datos:

En esta carpeta se guardarán los ficheros de bases de datos de la aplicación (ejemplo: ficheros .mdf y .ldf). Normalmente es preferible que no sea el mismo disco del sistema operativo, aunque no es obligatorio. Por ejemplo d:\db.

Además, debe ser un disco local desde el ordenador donde se ejecuta el SQL Server y accesible con las credenciales utilizadas por el servicio MSSQL$SQLEXPRESS.

¡Atención! Esta ruta hasta la carpeta no puede contener espacios.

Directorio de ficheros temporales e interface:

En esta carpeta se guardarán los ficheros temporales de la aplicación, así como los relacionados con las interfaces de datos o con los relojes de marcaje.

• SQL Express: Accederemos al asistente de instalación del SQL. Si no disponemos del programa SQL Server, deberemos instalarlo, tal y como se ha explicado en el apartado 1.1. Instalación SQL Server Express.
• Instalar: Grabará toda la información introducida y empezará la instalación.
• Cancelar: Cerraremos el asistente de instalación.

Lista de últimas versiones

Puedes consultar el histórico de cambios en cada release aquí.

3. Verificación

1. Verificaremos la instalación accediendo al siguiente enlace donde aparecen los webservices instalados: http://localhost/servers/Custom_Files/ISAPIBoldWP.dll Deberá aparecer una pantalla similar a la siguiente:

2. Por último, accederemos a la aplicación mediante el icono creado en su escritorio. Deberá salir algo como en la captura.

4. Resolución de problemas durante la instalación

En caso de error el instalador retornará una traza resumen en pantalla. Es importante enviar este archivo a soporte@gps-plan.com en caso necesario. Este archivo también se encuentra en la siguiente carpeta:

%TEMP%\log.txt --> traza que deja el script final de instalación (P)

Adicionalmente en esta misma carpeta se encuentra otro archivo con los detalles del proceso de configuración final de la instalación que también pueden ser de gran ayuda para resolver problemas:

%TEMP%\ClonCaseTask.log

Enviar ambos archivos a soporte@gps-plan.com como paso previo a cualquier consulta.

También puedes consultar los problemas más frecuentes en la instalación.

5. Copias de seguridad y traslado del servidor

El procedimiento de recuperación o traslado del servidor es el siguiente:

Copia de seguridad completa

1. Efectuar un backup de las bases de datos del servidor: Custom_Files y Custom_Files_users (esta última, la de usuarios, ya no es necesaria a partir de la v1.7.12).
2. Copiar también el fichero ubicado en:

C:\Program Files (x86)\Global Planning Solutions\Custom_Files\Integration\configuration\production\boldserver\AppendVarCustomFile.xml

Este fichero contiene las fórmulas de definición de nuevas columnas calculadas de los informes.

Restaurar copia

1. Reinstalar la aplicación.
2. Restaurar las bases de datos.
3. Restaurar el fichero AppendVarCustomFile.xml a su ubicación:

C:\Program Files (x86)\Global Planning Solutions\Custom_Files\Integration\configuration\production\boldserver\AppendVarCustomFile.xml

4. Ejecutar el programa de actualización (este paso puede ser opcional si no ha habido cambio de estructura de BD):
   1. Abrir un cmd.exe: cd C:\Program Files (x86)\Global Planning Solutions\BOLD Workplanner\server\servers\production\binWP
   2. Ejecutar el comando de upgrade de BD: PlannerConfig.exe /upgrade Custom_Files > %TEMP%\upgrade_output.log 2>&1
   3. Ejecutar: type %TEMP%\upgrade_output.log
   4. Si el resultado es correcto debe aparecer un mensaje similar al siguiente: La conexión a DESKTOP-P13BMAC\SQLEXPRESS fue exitosa La conexión a DESKTOP-P13BMAC\SQLEXPRESS fue exitosa Versión inicial: 8.06 (u otra versión superior)

6. Actualización de versión

El procedimiento de actualización de la versión se realiza con el instalador GT. Este instalador permite tanto la instalación de GT desde 0 como la actualización de una versión on premise existente.

Al ejecutar el instalador, si detecta que ya existe una versión anterior instalada de GT, aparecerá el botón “Actualizar”. Presionando el botón se actualizará la versión.

NOTA: es un requisito tener instalado el 7-zip para poder actualizar la versión desde el actualizador/instalador.

7. Desinstalación completa de Gestión del Tiempo

Consultar la página Desinstalar GT.

8. Instalación con dos servidores: uno para GT y otro para SQL Server

Si ya se dispone de un servidor de SQL Server en la red o bien nos interesa tenerlos separados es posible instalar GT en un servidor y configurarlo para utilizar un SQL Server distinto de la red.

Tras descomprimir el instalador, buscar la documentación “Procedimiento de instalación en doble servidor.docx” dentro de la carpeta GTTwoServers y seguir las instrucciones.

O consultar el artículo instalación con dos servidores