TN271WAS - Problemas de Deploy en System Platform

TN271WAS - Problemas de Deploy en System Platform

En este documento se detalla una lista de posibles causas por las que no se realiza un correcto “Deploy” en Application Server.

Errores Generales Presentes En System Platform

A continuación, mencionaremos una lista de parámetros que se deben revisar antes de buscar el error de manera específica:
1.    Asegurarse que las versiones en todos los nodos de System Platform sean las mismas.


Info
En ocasiones, el instalar un HF puede hacer cambiar la versión del producto.

2.  Pu ertos de Firewall habilitados para el correcto funcionamiento de System Platform

Leer documentación: AVEVA™ System Platform Installation Guide,  Appendix C: "Ports Used by System Platform Products"
Info
En la Guía de instalación de cada versión de System Platform, en el apartado de los apéndices, muestran los puertos que utiliza System Platform.

3.    Exclusión de antivirus


4.    Asegurarse que el usuario Archestra Network Admin Account sea el mismo en todos los servidores de la Galaxia.
     En el caso que no estuviesen con el mismo usuario y contraseña, modificarlo y volver a lanzar el Change Network Account, pulsando en “OK”, como se ve en la siguiente figura:


Alert
NOTA: Esta acción reiniciará el ordenador por lo que se deberá tomar en cuenta, si están en producción.
5.   Asegurarse que, el Archestra Network Admin Account se encuentre dentro del grupo aaAdministrators y Administrators, independientemente si están en dominio o Workgroup, como se observa en la siguiente figura:


6.   Asegurarse que las siguientes carpetas tengan permisos de lectura y escritura con el Archestra Network Account:
  1. aaFileRepository
  2. aaSF$
  3. ArchestrA Galaxy Data
En la siguiente imagen se puede observar la ubicación del los archivos mencionados anteriormente:


7.   Configuración de Windows – Folder Options, dejar en blanco la casilla “Use Sharing Wizard”

Desde la ruta indicada en la siguiente imagen:


8.  Deshabilitar IPv6

Desde la ruta indicada en la siguiente imagen, desmarcando la casilla (TCP/IPv6):


9.  Si se está trabajando con versiones anteriores a System Plaftorm 2017, revisar la configuración del DCOM y crear usuario Everyone con todos los permisos.



Luego, volver a ejecutar el OsConfigurationUtility  desde Windows.


Alert
NOTA: Esta acción reiniciará el ordenador por lo que tomar en cuenta si están en producción.

10.   Revisar que la tarjeta de red que tiene la red Archestra, tenga la métrica automática desactivada y con valor más bajo configurado en IPv4, “1”, como se observa en la siguiente imagen:


  

11.  UAC preferiblemente desactivado: Inicio>User Account Control Settings




12.   Configuración Regional de Estados Unidos




13.   Deshabilitar TOE
  1. En el servidor de Microsoft® Windows®, abra el Panel de control.
  2. Seleccione Red e Internet > Centro de redes y recursos compartidos > Cambiar configuración del adaptador.
  3. Haga clic con el botón derecho en cada uno de los adaptadores públicos y privados, seleccione Configurar en el menú Redes y haga clic en la pestaña Avanzado. La ventana muestra la configuración de descarga de TCP para el adaptador Citrix como se muestra en la siguiente imagen:
       
Seleccione cada una de las siguientes opciones de descarga de TCP, cambie el valor a Deshabilitado y haga clic en Aceptar:
  1. IPv4 Checksum Offload
  2. IPv4 TSO Offload
  3. Large Send Offload V2 (ipv4)
  4. Large Send Offload V2 (ipv6)
  5. Offload IP Options
  6. Offload taggered traffic
  7. Offload TCP Options
  8. Receive Side Scalling
  9. Recv Segment Coalescing (IPv4)
  10. Recv Segment Coalescing (IPv6)
  11. TCP Checksum Offload (IPv4)
  12. TCP Checksum Offload (IPv6)
  13. UCP Checksum Offload (IPv4)
  14. UDP Checksum Offload (IPv6)  
14. Archivo HOST

Todos los nodos de su Galaxy deben poder comunicarse entre sí utilizando tanto la dirección IP como el Node Name.  Si las máquinas de la Galaxia utilizan direcciones IP fijas, cree un archivo de hosts con el nombre de host para la asignación de direcciones IP. Pueden surgir problemas de conexión con WinPlatform, en caso de no poder acceder a las computadoras mediante el nombre de host y la dirección IP, esto, sin importar qué tipo de dirección de red elija usar. 

Se debe hacer ping entre todos los nodos que se estén comunicando y en ambas direcciones, es decir, ping NodoA con NodoB y NodoB con NodoA.
Para asignar un nombre a una dirección IP se lo realiza de la siguiente manera: 
  1. Dirigirse al siguiente directorio: C:\Windows\System32\drivers\etc\hosts y lo ejecutamos como Administrador para hacer cambios.
  2. Abrimos con Bloc de notas y asignamos el nombre de la máquina con la IP que tenga asociada:
       
Alert
NOTA: Este paso no se debe realizar si hay un DNS configurado en Dominio

15.   Servicios instalados correctamente

Revisar que se hayan instalado los componentes de Application Server correctamente, como, por ejemplo: Bootstrap y el Watchdog.
  1. Instale el IDE y Bootstrap en cualquier PC que navegue por la galaxia. 
  2. Instale Bootstrap y Deploy una plataforma en cualquier PC que sea un AOS (servidor de objetos de aplicación)
Para más información se debe seguir la guía de instalación dependiendo de la versión del producto y revisar la arquitectura del proyecto.

16.   Revisar la configuración DCOM de Windows.

Los Puertos DCOM utilizados por el Bootstrap son los siguientes:
      - Puerto 135
      - Puerto 139
      - Puerto 445
      - Puerto desde 1024 hasta 65535
Comprobar que los siguientes parámetros estén configurados:
  1. Asegurarse que el Authentication Level se encuentre en None buscando Components Services en Windows y entrando a WWPim.
       
  1. En la misma ventana, vamos a la pestaña de Location y comprobamos que la aplicación se ejecute en la máquina.
       
  1. En la pestaña de Seguridad, revisamos que los tres permisos, tengan permiso total:
       
  1. En la pestaña Identity, ingresar el usuario y contraseña definida como Network Account:
       

17.   Comprobar que la misma configuración que se realizó en el anterior paso para WWPim  se haga para DCOMTransport (seguir paso 16).

18.   Asegurarse que este habilitado “Enable Distributed COM in this computer”, desde el Component Services, como se muestra en la siguiente figura:


19.   Revisar la configuración de Windows – “Local Security Settings"
  1. Dirigirse a Local Security Policy desde la ruta que aparece en la siguiente imagen:
       
  1. En Security Options, hacemos doble clic en Network access: Sharing and security model for local accounts y seleccionamos Classic finalmente OK para guardar .
       

  1. (REALIZAR EL SIGUIENTE PASO, SOLO SI SE ESTÁ TRABAJANDO EN WORKGROUP)  Habilitamos el “Network Access: Let Everyone permissions apply to Anonymous users”, desde Security Options de Windows:
       

  1. En User Rights Assignment, asegurarse que en “Log on as a Service” esté el usuario Network Account, como se observa en la siguiente imagen: 
       
  1. Al igual que el anterior punto, asegurarse que el Archestra Network Admin Account esté añadido en las siguientes políticas:
            - Log on as a batch job
            - Deny log on locally (OPCIONAL)
            - Deny log on through Remote Desktop Services (OPCIONAL)

  1. Asegurarse que Archestra Network Admin Account no se encuentre en las políticas Deny log on as a service:
       



Incidencias Adicionales Que Pueden Presentarse En Un Problema De Deploy

En ocasiones, realizando los pasos anteriores, el problema de Deploy continua y puede ser debido a un error más específico de instalación o del propio servidor. Para ello se tiene que revisar los siguientes puntos:

1.   Realizar un Scan con el Common Service Portal y asegurarse que los servicios estén funcionando correctamente:

En caso de haber un error en el Status, al momento de hacer un Scan, muestra la causa del mismo.

2.   Asegurarse que no haya otra plataforma de otra Galaxia desplegada (SMC)



En caso de haber otra galaxia desplegada, Undeployarla o ejecutar el Platform Remover (Pedir el ejecutable a Soporte Técnico). Aparecerá una ventana similar a la siguiente imagen:



3.   Permisos NA en C:\Program Files(x86)\ArchestrA\Framework\Bin

Es importante revisar la comunicación que existe entre servidores. Una manera  de comprobar la comunicación entre nodos es: copiar un archivo desde el directorio mostrado ( C:\Program Files(x86)\ArchestrA\Framework\Bin ) y pegar el archivo copiado en otro servidor de la plataforma en la misma ruta, SIN REEMPLAZAR, solo para comprobar que te permita realizar un copy-paste, de un servidor a otro, en ambas direcciones.

De esta forma comprobamos que existe comunicación entre servidores de System Platform.

En caso que no te permita realizar esta función, hay que revisar los permisos que se tienen entre servidores (Ver paso 6 de ERRORES GENERALES PRESENTES EN SYSTEM PLATFORM).

Clasificación De Errores Según El Mensaje En Log Viewer

1.   “Deploy Failed -The Server is unavailable  HRESULT = 80070005”
SOLUCIÓN: Revisar las KB instaladas o las actualizaciones que tuvo Windows. Seguir la Tech Alert: “System Platform issues with Microsoft Update KB5004442 - DCOM Hardening”

2.   “A platform with the same platform id, same hostaddress has already been deployed”
SOLUCIÓN: Revisar el apartado ERRORES GENERALES PRESENTES EN SYSTEM PLATFORM, punto 4, Change Network Account, de este documento.

3.   “Deploy error - CoCreateInstance on BootstrapController failed”
SOLUCIÓN: Revisar el apartado ERRORES GENERALES PRESENTES EN SYSTEM PLATFORM, punto 13 y 14, Revisar la configuración DCOM de Windows WWPim y DCOMTransport.

4.   “FCS: Received Archestra user 'wwsystemcomm' password from the GR node does not match to the local password.”
SOLUCIÓN: Revisar el apartado ERRORES GENERALES PRESENTES EN SYSTEM PLATFORM, punto 4, Change Network Account, de este documento.

5.   “Failed to deploy : Remote Node's UserId/Password don't match GR Node's”
SOLUCIÓN: Revisar el apartado ERRORES GENERALES PRESENTES EN SYSTEM PLATFORM, punto 4, Change Network Account, de este documento. 

6.   “Fail to deploy - Platform startup failed”
SOLUCIÓN 1: 
             o Revisar el apartado ERRORES GENERALES PRESENTES EN SYSTEM PLATFORM, punto 4 y 8.
             o Ejecutar el CMD como administrador de Windows y añadir NT SERVICE\aaPim al grupo Administrator con el comando: 
                    net localgroup Administrators /add "NT SERVICE\aaPim"
SOLUCIÓN 2:
Seguir la FAQ4142, “Error: 'Platform Startup Failed.' on attempt to deploy platform. Unable to Deploy platform.”

7.   “Failed to undeploy platform: Cannot communicate with remote node - Failed to create a remote interference for the version information from Bootstrap” 
SOLUCIÓN: 
             o Seguir los pasos de ERRORES GENERALES PRESENTES EN SYSTEM PLATFORM
             o Eliminar los archivos.cpk localizados en:
                    C:\Program Files (x86)\ArchestrA\Framework\Bin\CheckPointer.
             o Reiniciar los servicios de Bootstrap y volver a Deployar la plataforma.

8.   "Error aaPim Could not Internal_AddFilesToNode:AddFilesToMergeModuleMSIFile. No such interface supported (80004002) raised at line 258 in PimPF.cpp (in )."
SOLUCIÓN: 

9.   "Failed to deploy PlatformName : Platform startup failed : The target platform failed to start."
SOLUCIÓN:

10.  "Failed to deploy Winplatform_001: Failed to deploy code modules to target"
SOLUCIÓN:

11. "Error aaPim Could not AuthenticateClient. Access is denied. (80070005) raised at line 458 in PinPF.cpp"
SOLUCIÓN: 
Revisar el apartado ERRORES GENERALES PRESENTES EN SYSTEM PLATFORM, punto 4, Change Network Account, de este documento.

12. "Warning  aaBootstrap ImpersonateUser failed(0x8000401a). ArchestrA Admin user has not been setup or machine is shutting down "
SOLUCIÓN:

¿EL PROBLEMA PERSISTE Y TODAVIA NO SE RESUELVE?

Si el problema persiste después de haber realizado los pasos anteriores, comunicarse con el Soporte Técnico de BECOLVE DIGITAL aportando la siguiente información:

1.   Exportar y enviar los mensajes que aparecen en el Log Viewer en formato .aaLGX, junto con una trazabilidad (indicando la hora exacta y/o poniendo marcas) que indique la fecha donde se produjo el error.

2.   Exportar desde Windows:
          -  Visor de eventos>Registros de Windows>Sistema.
          -  Visor de eventos>Registros de Windows>Aplicación.

3.   Indicar la versión que tiene instalada de System Platform, lo puede ver desde el panel de control, junto con la versión de sistema operativo, para ello puede ejecutar “winver” desde Windows como se ve a continuación: