Instalación del módulo fullweb

Requisitos previos

En primer lugar es necesario instalar tres utilidades, si se ha seguido el proceso estandard de instalación estarán en C:\SW base instalaciones\Software base\node

• node-v8.9.4-x64
• iisnode-full-v0.2.16-x64.msi que instala el modulo iisnode en el IIS. En Windows Server 2016 se ha instalado iisnode-full-v0.2.21-x64.msi
• rewrite_x64_es-ES.msi que permite utilizar reglas de reescritura de URL en el IIS.

Nota: Hay que tener en cuenta que en Windows 10 no hay forma de instalar el Rewrite, da un error referente a la version del IIS y para solventarlo hay que seguir estos pasos:

• Open Regedit > HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\InetStp
• Edit “MajorVersion” and set the “DECIMAL” value to 9
• Hit F5 while in Regedit
• Now go install the ReWrite 2.0 module.
• Change the “MajorVersion” back to “DECIMAL” value of 10
• Hit F5 while in Regedit
• Close Regedit

Procedimiento automático de actualización

Documentado en: \gpsnode\docs\readme.txt

1. Copiar el archivo gpsnode.7z generado anteriormente en una carpeta temporal (y el node_modules_setup.7z si hace falta). Por ejemplo en c:\temp
2. Copiar el script \gpsnode\install.bat también en la carpeta temporal. (este archivo lo puedes extraer del propio fichero comprimido gpsnode.7z)
3. Abrir un cmd.exe como administrador y situarse en la carpeta temporal (cd c:\temp)
4. Ejecutar el comando: install “c:\temp\gpsnode.7z” “C:\Program Files (x86)\Global Planning Solutions\gpsnode”
   (ejemplos de carpeta origen donde hemos dejado el 7z y la carpeta destino de la instalación)
5. Ahora debemos escoger el skin. Por defecto se queda instalado en modo WKE. Si queremos poner el de GPS hay que hace esto:
   5.1 Ir al fichero dist\skin.js y dejar la linea “window.themeName” comentada que corresponda.

Procedimiento manual de instalación

En una instalación estandard en la que se hayan ejecutado los *.bat de instalación este paso no sera necesario, y las carpeta gpsnode y node_modules ya estarán creadas.

Para desplegar el fichero gpsnode.zip procederemos de la siguente manera:

• Abrir 7-zip en como administrador
• Localizar el fichero gpsnode.zip dentro de su explorador integrado
• Seleccionar la opción de descomprimir sobre la carpeta C:\Archivos de programa (x86)\Global Planning Solutions

El fichero node_modules.zip contiene el conjunto de librerías que necesita la aplicación para ejecutarse. Normalmente no cambian entre dos versiones con lo cual no suele ser necesario actualizarlas cada vez. Para desplegarlo procederemos de la siguente manera:

• Abrir 7-zip en como administrador
• Localizar el fichero node_modules.zip dentro de su explorador integrado
• Seleccionar la opción de descomprimir sobre la carpeta C:\Archivos de programa (x86)\Global Planning Solutions\gpsnode (que se habrá creado en el paso anterior)

Nota: Después de descomprimir el gpsnode hay que ejecutar el siguiente comando

node replaceDist.js “C:\Program Files (x86)\Global Planning Solutions\gpsnode”

Configuración de los ficheros gpsnode.js, web.config, BOLDXML.json y BOLDServer.json

En una instalación estandard de productivo estos pasos no serán necesarios, ya habrán sido ejecutados por los bats de instalación.

gpsnode.js

• Renombrar el fichero C:\Archivos de programa (x86)\Global Planning Solutions\gpsnode\gpsnode_setup.js a C:\Archivos de programa (x86)\Global Planning Solutions\gpsnode\gpsnode.js. Esto también se hará solo en la primera instalación.
• Editaremos este último fichero:
  • En process.env.client pondremos el nombre del caso, por ejemplo ‘DemoTiendas’. (en instalaciones estandard Custom_Files)
  • En process.env.casetype en instalaciones estandard development, copia_prod, traininig o workplanner

web.config

• Renombrar el fichero C:\Archivos de programa (x86)\Global Planning Solutions\gpsnode\web_setup.config a C:\Archivos de programa (x86)\Global Planning Solutions\gpsnode\web.config. Esto también se hará solo en la primera instalación. Normalmente el contenido de este fichero ya está bien configurado.

BOLDXML.json y BOLDServer.json

En la carpeta C:\Program Files(x86)\Global Planning Solutions\\Integration\configuration\ deben existir los ficheros BOLDXML.json y BOLDServer.json.

Creación de un servidor node en el IIS

• Abrir un CMD como administrador en /BOLDXML2/bat
• A continuación ejecutar

addgpsnode_setup gpsnode <usuario_maquina> <password_maquina>

Esto creará el pool de aplicaciones gpsnode y la aplicación gpsnode en Default Web Site, si no aparecen hacer un IIS reset.

NOTA IMPORTANTE: En instalaciones que el IIS solo contenga el gpsnode hay que hacer un ultimo paso manualmente, en el menú de la derecha la opción Modificar permisos de características para la el sitio web que estamos configurando (gpsnode en este caso) y marcaremos la opción de ejecutar. Revisar Asignación de controladores

Si es necesario se pueden revisar los pasos para le creación de forma manual:

• En primer lugar crearemos un Grupo de aplicaciones estándar al que llamaremos gpsnode. Podrá ser de tipo .NET Framework y con Modo de canalización administrada Integrada( lo que sale por defecto al dar de alta un nuevo Grupo de aplicaciones).
• A continuación iremos a Default Web Site y ejecutaremos Agregar aplicación…. Se deberá poner como alias gpsnode, como grupo de aplicaciones gpsnode( creado en el punto 1) y como ruta de acceso física C:\Proyectos\Clientes\gpsnode( o donde tengamos descargado gpsnode del svn). En Conectar como… introduciremos un usuario y una contraseña específicos.
• El siguiente paso es ir a Asignación de controladores y a la derecha aparecerá una lista de acciones. Seleccionar Agregar asignación de módulo…. Asignaremos un módulo con las siguientes características:
  • Ruta de acceso de solicitudes iisnode,
  • Módulo iisnode y nombre iisnode.