Actualización con gps-agent

Elementos a comprobar

• Comprueba que la instalación actual está funcionando (gpsnode, portal, etc.)
• Confirma que la versión de Node.js instalada es superior o igual a la 14
  • Para ello abre una terminal y escribe el comando: node -v
• Determina si la máquina tiene acceso a internet externo (por ejemplo, visita wikipedia)

Una vez realizadas las comprobaciones, sigue las instrucciones que mas se adecúen a tu caso.

Actualización sin acceso a internet

En una actualización sin acceso a internet tendrás que llevar los ficheros de forma manual a la máquina que vas a actualizar.

Archivos necesarios (sin internet)

• Versión que se va a instalar
  • La podrás encontrar en el servidor FTP dentro de la carpeta releases o accediendo al siguiente enlace modificando las X por el nombre de la versión: https://www.gps-plan.com/setup/releases/XXXXX.7z
  • Lo tendrás que llevar a la carpeta %TEMP% (sin descomprimir)
• GPS-AGENT
  • Lo puedes obtener en este enlace.
  • Lo tendrás que llevar a C:\Program Files (x86)\Global Planning Solutions\agent
• Archivo .yml correspondiente al tipo de instalación (productivo, desarollo, etc)
  • Los podrás encontrar en el servidor FTP dentro de la carpeta deployments/utils
  • Lo tendrás que llevar a C:\Program Files (x86)\Global Planning Solutions\agent
• Versión igual o superior a Node.js si la versión instalada es inferior
  • La puedes descargar de su página oficial.
  • Instálalo en la máquina y verifica que la versión es la correcta con el comando node -v

Últimas verificaciones (sin internet)

Es posible que las rutas del fichero .yml no coincidan con las de la máquina en la que vas a realizar la actualización, es por ello que es conveniente abrir el .yml con el notepad y asegurarte.

Iniciar la actualización (sin internet)

Ve a la ruta donde tienes el gps-agent y el .yml. Abre una terminal como administrador (cmd o PowerShell) y escribe:

.\gps-agent.exe execute -c .\fichero.yml -s Upgrade

El texto azul indica la ubicación del gps-agent.
El texto naranja indica la ubicación del fichero .yml
El texto rojo indica la Stage del .yml, lo podrás ver en la primera línea del .yml o tras la palabra:  – stage:

Al pulsar intro, el agente te pedirá el nombre de la versión y deberás añadirlo sin la extensión, un ejemplo sería escribir: v1.9.1-P5

Actualización con internet

En una actualización con internet no hace falta llevar ningún tipo de archivo ya que te los puedes descargar desde la propia máquina.

Archivos necesarios

• GPS-AGENT
  • Lo puedes obtener en este enlace.
  • Lo tendrás que llevar a C:\Program Files (x86)\Global Planning Solutions\agent
• Conocer la url del .yml que vas a utilizar
  • Los podrás encontrar en el servidor FTP dentro de la carpeta deployments/utils
  • Un ejemplo de URL sería: https://www.gps-plan.com/setup/deployments/utils/upgrade-prod.yml
• Versión igual o superior a Node.js si la versión instalada es inferior
  • La puedes descargar de su página oficial.
  • Instálalo en la máquina y verifica que la versión es la correcta con el comando node -v

Últimas verificaciones

Es posible que las rutas del fichero .yml no coincidan con las de la máquina en la que vas a realizar la actualización. Si no coinciden, tendrás que descargarte el fichero (clic derecho y Guardar como) y editarlo de forma local. El proceso de actualización entonces, será idéntico al de sin acceso a internet.

Iniciar la actualización

Ve a la ruta donde tienes el gps-agent y el .yml. Abre una terminal como administrador (cmd o PowerShell) y escribe:

.\gps-agent.exe execute -c https://www.gps-plan.com/setup/deployments/utils/upgrade-prod.yml -s Prepare

.\gps-agent.exe execute -c https://www.gps-plan.com/setup/deployments/utils/upgrade-prod.yml -s Upgrade

El texto azul indica la ubicación del gps-agent.
El texto naranja indica la url del fichero .yml
El texto rojo indica la Stage del .yml, lo podrás ver en la primera línea del .yml o tras la palabra:  – stage:

Nota 1. Al pulsar intro, el agente te pedirá el nombre de la versión y deberás añadirlo sin la extensión, un ejemplo sería escribir: v1.9.1-P5

Nota 2. El ejemplo anterior se descarga el fichero de instrucciones de internet. Sino será necesario referencia el fichero previamente descargado en la carpeta local. Si se ha descargado el fichero de instrucciones, entonces tendremos que editar la sección de download que para que no la realice sino que coja el fichero 7z de instalación de la carpeta TEMP que se supone ya tendremos allí.

Actualizar portal (Tomcat)

Para actualizar el portal, visita el siguiente artículo.