Instala y gestiona los GroundRunners

Los GroundRunner permiten que los comandos en cadena interactúen con sistemas locales o fuentes de datos remotas a las que no se puede acceder de otro modo a través de Internet. Suelen ser instalados en un servidor dedicado, como el que aloja tu fuente de datos conectada, por un profesional informático o por alguien familiarizado con la configuración de red de tu organización.

Antes de configurar un GroundRunner, te recomendamos que revises la arquitectura de seguridad del Generador de cadenas.

Requisitos

Se necesita un sistema operativo compatible, y si tu GroundRunner va a acceder a recursos compartidos como una ruta de la Convención Universal de Nombres de Windows (UNC), también se necesita una cuenta de usuario con privilegios suficientes.

No se ha instalado un entorno de ejecución de Java (JRE) con GroundRunner durante la instalación inicial de GroundRunner.

Una vez completada la configuración y con el GroundRunner en funcionamiento, este descargará automáticamente un JRE según sea necesario para ejecutar comandos que dependen de Java. No se requiere instalación ni intervención del administrador, y el JRE recuperado no afectará a las instalaciones existentes de JRE si existen en el host.

Como alternativa, si tienes requisitos organizativos que requieran el uso de un JRE concreto, la variable de entorno SHARED_LIBRARY_OVERRIDES puede establecerse para que apunte a la instalación del sistema. En este caso, el GroundRunner no descargará automáticamente el JRE estándar de Workiva, y utilizará la instalación del JRE del sistema proporcionado.

Los JRE suministrados por Workiva tienen licencia GPL v2 y están cubiertos por la excepción de ruta de clase .

Nota: Para utilizar certificados personalizados con tu instalación de Java, consulta Utilizar certificados personalizados con GroundRunners.

En este momento, es posible instalar GroundRunner en las siguientes familias de sistemas operativos sin dependencias de bibliotecas externas:

Windows y Windows Server
Distribuciones de Linux y derivados:
- RedHat, Fedora, AmazonLinux
- Debian/Ubuntu
macOS (solo para pruebas)

Workiva se esfuerza por admitir todas las versiones modernas de las familias de SO enumeradas anteriormente. Sin embargo, no podemos dar soporte a ningún sistema operativo que haya sido designado como "fin de vida" por su proveedor. Estos sistemas operativos antiguos plantean riesgos potenciales de seguridad y deben actualizarse a una versión actual lo antes posible. Más información: sobre nuestra política para el final de la vida.

Nota: El calendario de soporte de cada sistema operativo lo establece cada proveedor. Por ejemplo, el soporte de Microsoft para Windows 7 finalizó el 14 de enero de 2020; el soporte de Workiva para Windows 7 finalizó en la misma fecha.

Requisitos de hardware

Aunque los GroundRunners requieren recursos de servidor limitados, recomendamos como mínimo:

512 MB de memoria de acceso aleatorio (RAM) disponible
100 GB de espacio disponible en disco

Nota: Para ayudarte a calcular el espacio en disco necesario, debes saber que una cadena con cinco comandos que produzcan, cada uno de ellos, resultados efímeros de 10 MB requiere 50 MB para completarse.

La configuración de host recomendada incluye una máquina virtual configurada con:

De dos a cuatro procesadores

Nota: Los procesadores basados en ARM no son compatibles con los GroundRunner.
8 GB de memoria del sistema
Un dispositivo de almacenamiento de unidad de estado sólido (SSD)

Este servidor debe estar disponible en todo momento, para comunicarse con GroundRunner.

Por defecto, los GroundRunner utilizan una cuenta administrativa local sin acceso a recursos remotos como las unidades compartidas.

Para acceder a un recurso compartido, como una ruta UNC de Windows, inicia el GroundRunner con una cuenta de usuario con privilegios adecuados al recurso. Si utilizas una cuenta de usuario distinta a la del administrador local del sistema por defecto, concédele permisos para gestionar el directorio de instalación de GroundRunner para activar las actualizaciones automáticas.

Requisitos de rol

En la plataforma Workiva

En la plataforma Workiva, necesitas un rol que otorgue acceso a la configuración del Generador de cadenas y la capacidad de gestionar los Runners. Hay dos:

Propietario de cadena: este es el rol principal requerido. Los usuarios con este rol pueden acceder a la sección "Descargas" en Chain Builder para obtener los últimos archivos de instalación de GroundRunner y gestionar la pestaña "Runners" para activar o monitorear el servicio.
Administrador de seguridad de cadenas de la organización: este rol a nivel organizacional también tiene la autoridad para gestionar conexiones y runners en múltiples espacios de trabajo.

En el servidor

Debido a que una "actualización manual" implica detener servicios y reemplazar archivos ejecutables en la máquina física o virtual donde está instalado el GroundRunner, el usuario debe tener privilegios administrativos en el servidor host.

Windows: debes tener la capacidad de ejecutar la instrucción de comando como administrador y acceder al Administrador de servicios de Windows (para detener y reiniciar el servicio GroundRunner).
Linux/macOS: Debes tener acceso sudo o root para mover archivos al directorio de instalación y reiniciar el proceso en segundo plano.

Descargar el GroundRunner

Para descargar un GroundRunner para su instalación o actualización manual:

En la barra lateral de la página principal de Workiva, haz clic en Cadenas.
En la barra lateral del Generador de Cadenas (es una pestaña nueva), haz clic en Conexiones.

Alternativamente, puedes hacer clic en el ícono de perfil de usuario en la parte superior derecha, seleccionar Administrador de Chains, y luego Configuración del espacio de trabajo.
Haz clic en Descargas en la barra de menús superior.
Busca el GroundRunner de tu sistema operativo y haz clic en Descarga.
Una vez que se haya descargado correctamente en tu ordenador, selecciona las instrucciones apropiadas del conjunto de abajo, y síguelas para instalar la GroundRunner.

Instala el GroundRunner

El instalador de Microsoft (MSI) requiere .NET 3.5 o superior.
Si no puedes cumplir con este requisito, deberás instalar el GroundRunner usando la interfaz de línea de comandos.

Para instalar el GroundRunner:

Descomprime GroundRunner.zip en una carpeta nueva y ábrela.
Ejecuta GroundRunner.msi para abrir el asistente de instalación de GroundRunner.
Haz clic en Siguiente.
Revisa y acepta los términos del acuerdo de licencia, y haz clic en Siguiente.
En Carpeta de destino, ingresa la ruta donde se instalará el GroundRunner (por ejemplo: C:\Program Files\GroundRunner\) y haz clic en Siguiente.
En Token de la empresa de la plataforma, ingresa tu token de la empresa.
En Plataforma auth host:
- Para APAC, ingresa h.apac.wdesk.com/s/chains-reaper.
- Para Canadá, ingresa h.ca.wdesk.com/s/chains-reaper.
- Para EMEA, ingresa h.eu.wdesk.com/s/chains-reaper.
- Para Estados Unidos, Centroamérica y Sudamérica, ingresa h.app.wdesk.com/s/chains-reaper.
Si usas un servidor proxy, ingresa su URL y puerto en Host de proxy.
(Por ejemplo, http://yourproxy:3000.)
Para omitir el servidor proxy, ingresa una lista de hosts separados por comas en Sin host de proxy.
Haz clic en Siguiente, Instalar, y Finalizar.
Una vez instalado, haz clic derecho en el GroundRunner desde el Administrador de servicios de Windows y selecciona Iniciar.

Tu GroundRunner ya ha sido instalado y está listo para ser activado.

Para instalar mediante la interfaz de línea de comandos, debes descargar la instalación de GroundRunner en su propio directorio dentro de tus archivos de programa (por ejemplo, c:\Program Files (x86)\wdata). Luego puedes descomprimir el archivo de instalación y extraerlo en la raíz de ese directorio.

Después puedes instalar el GroundRunner:

En la ventana de comandos de Windows, ingresa
```
c:\Program Files (x86)\wdata\installer.exe install
```
y acepta todos los valores predeterminados.
- Selecciona "windows" para el sistema de inicio.
  
  Debes especificar que el GroundRunner funcionará como un servicio de Windows para que sea compatible con actualizaciones automáticas. Los GroundRunners solo deben ejecutarse como servicio, excepto con fines de prueba.
- Para la ruta, crea una carpeta Files dentro del nuevo directorio
  (por ejemplo, C:\Program Files (x86)\Wdata\Files).
- Para el nombre de host de autorización (AUTH_HOST):
  - Para APAC, ingresa h.apac.wdesk.com/s/chains-reaper.
  - Para Canadá, ingresa h.ca.wdesk.com/s/chains-reaper.
  - Para EMEA, ingresa h.eu.wdesk.com/s/chains-reaper.
  - Para Estados Unidos, Centroamérica y Sudamérica, ingresa h.app.wdesk.com/s/chains-reaper.
- Ingresa tu token de la empresa.
Elimina todos los archivos del directorio, excepto el directorio ejecutable GroundRunner.
Selecciona si quieres ejecutar el GroundRunner como un servicio o como un proceso en primer plano.
- Si se ejecuta como servicio, haz una de las siguientes cosas:
  - En el cuadro de diálogo de comandos, ingresa sc start GroundRunner.
  - En el Administrador de servicios de Windows, inicia el servicio GroundRunner.
- Si se ejecuta como proceso en primer plano, en el cuadro de diálogo de comandos ingresa:
```
cd c:\Program Files (x86)\wdata GroundRunner.exe
```

Tu GroundRunner ya está instalado y listo para activarse.

Paso 1. Instalar el GroundRunner

Descarga el archivo de instalación de GroundRunner en su propio directorio,
por ejemplo: /home/user_name/wdata/.

Nota: "/home/user_name/wdata" se proporciona como ejemplo. Sigue la política de tu organización para las ubicaciones de instalación de servicios.
En un cuadro de diálogo de comandos, descomprime el archivo de instalación usando:
```
unzip GroundRunner.zip
```
Ingresa los detalles del GroundRunner.
1. Ingresa ./installer install
2. Para el nombre de host de autorización (AUTH_HOST):
  - Para APAC, ingresa h.apac.wdesk.com/s/chains-reaper.
  - Para Canadá, ingresa h.ca.wdesk.com/s/chains-reaper.
  - Para EMEA, ingresa h.eu.wdesk.com/s/chains-reaper.
  - Para Estados Unidos, Centroamérica y Sudamérica, ingresa h.app.wdesk.com/s/chains-reaper.
3. Ingresa tu token de la empresa.
Elimina todos los archivos del directorio excepto la carpeta que se creó durante el proceso de instalación.

Paso 2. Configura tu GroundRunner como un servicio systemd (Linux)

Para garantizar que las actualizaciones automáticas de GroundRunner funcionen y para una buena práctica del GroundRunner, este debe instalarse como un servicio systemd habilitado y reiniciable. Consulta la documentación de tu sistema operativo y la política de tu organización sobre cómo ejecutar el GroundRunner como un servicio systemd.

Para configuraciones básicas, tenemos los siguientes requisitos de archivo de unidad systemd para que las actualizaciones automáticas funcionen correctamente:

Asegúrate de que el ejecutable ExecStart apunte al binario GroundRunnerMonitor y NO al binario
GroundRunner.
Establece Restart=always.
No configures StartLimitBurst o StartLimitIntervalSec, ya que estos pueden evitar que el GroundRunner se reinicie debido a errores transitorios. Si deseas evitar que el GroundRunner entre en un bucle de reinicio rápido, puedes configurar RestartSec.
Ingresa systemctl enable para habilitar la unidad de servicio systemd de GroundRunner de manera que este sobreviva a un reinicio.

Workiva no ofrece soporte oficial para ejecutar un GroundRunner como proceso en primer plano. Esto puede ser útil para probar una configuración, pero, una vez configurado un GroundRunner, debe establecerse como un proceso de fondo de larga duración.

Operación de GroundRunners en macOS (solo para pruebas)

Workiva admite GroundRunners en macOS solo con fines de prueba. Aunque los GroundRunners en macOS pueden ejecutar los mismos comandos que las versiones de Linux y Windows, Workiva no admite oficialmente launchd como administrador de servicios válido. Esto se debe a que Apple discontinuó el soporte para su software de servidor macOS en 2022. Las computadoras portátiles y de escritorio de Apple no son adecuadas para ejecutar GroundRunners.

Activar el GroundRunner

Después de instalar tu GroundRunner, debes activarlo dentro del Generador de cadenas.

En la barra lateral del Generador de cadenas, haz clic en Conexiones.
Haz clic en Corredores en la parte superior y, a continuación, haz clic en Pendiente de inscripción.
Ingresa un nombre breve y descriptivo para el runner.
Por ejemplo, "<datasource>-GroundRunner".
Si deseas recibir avisos cuando el GroundRunner deje de estar en buen estado, activa el interruptor Notificarme cuando este runner no esté en buen estado a "Activado" (se vuelve azul).
Haz clic en Activar.

Lista de verificación de configuración de GR

¿Estás ejecutando el ejecutable GroundRunnerMonitor (en lugar del ejecutable GroundRunner)?
¿Has configurado tu GroundRunnerMonitor como un servicio a nivel de sistema, reiniciable?
- Para Linux: Systemd.
- Para Windows: Servicios de Windows.
¿Se reinicia tu servicio al reiniciar el sistema?
- En Linux: systemctl enable.
- En Windows: Tipo de inicio configurado en Automático.
¿Estás ejecutándolo en un sistema operativo de servidor compatible?
¿Tienes habilitadas las notificaciones de GroundRunner?

Actualiza manualmente un GroundRunner

Aunque rara vez es necesario, es posible que tengas que actualizar manualmente un GroundRunner.
Consulta la página de Soporte de Workiva Actualización manual de GroundRunner para conocer las instrucciones sobre cómo hacer esto.

Desinstalar un GroundRunner

Si ya no necesitas un GroundRunner, puedes desinstalarlo.

Desde la Configuración de Windows, ve a Aplicaciones y características, selecciona GroundRunner (64 bits), y haz clic en Desinstalar.

Detén el servicio GroundRunner.
- Si se está ejecutando como servicio, usa el Administrador de servicios de Windows, o ingresa
  sc stop GroundRunner en una ventana de comandos.
- Si se está ejecutando como proceso en primer plano, presiona Ctrl+C.
En el cuadro de diálogo de comandos, como administrador, ingresa
installer.exe uninstall.
Elimina el directorio ejecutable GroundRunner.

En el cuadro de diálogo de comandos, detén el servicio GroundRunner y elimina su directorio ejecutable (por ejemplo, /home/<username>/wdata/Contents).

Instalar un JRE a medida

Si es necesario, puedes instalar tu propio JRE para dar soporte a un GroundRunner. La versión de Java de este JRE debe coincidir con la requerida para el GroundRunner. Aparte de los GroundRunners Oracle Essbase y Oracle Hyperion Financial Management (HFM), todos los GroundRunners utilizan la misma versión de JRE.

Para obtener información sobre cómo instalar un JRE personalizado, consulta Deshabilitar bibliotecas compartidas de Workiva.

Ajustes de configuración de GroundRunner y dominios de salida

Para permitir la comunicación con su fuente de datos, puede que tengas que abrir puertos de cortafuegos en el servidor donde esté instalado el GroundRunner. Para cambiar los ajustes de configuración de algunos GroundRunner, puedes editar el archivo GroundRunner.config en el directorio donde están instalados los binarios.

Configuración	Configuración
PUERTO	0 a 65535. De forma predeterminada, los GroundRunner utilizan el puerto 8821 para comunicarse entre sí. Sin embargo, solo es necesario un puerto si los GroundRunner de distintos servidores comparten salidas de comando dentro de tu red.
COMPANY_TOKEN	Déjalo como predeterminado, a menos que el GroundRunner esté configurado para un arrendatario diferente.
LOG_LEVEL	Información o corrección de errores
PROTOCOLO	Déjalo con el valor predeterminado.
HTTP_PROXY_URL	Si utilizas un servidor proxy, introduce su URL y el puerto (si es necesario). Por ejemplo, `http://yourproxy:3000` Nota: Los GroundRunner pueden utilizar servidores proxy, pero no los autenticados mediante New Technology LAN Manager (NTLM). En su lugar, permite la dirección IP del servidor.
LONG_POLL	Si utilizas un servidor proxy, establece en verdadero para indicar al ejecutor que utilice el sondeo largo para recuperar comandos. Para garantizar el rendimiento, utiliza el sondeo largo solo si el servidor proxy o el cortafuegos no admiten sockets web.
NO_PROXY	Para evitar el servidor proxy, proporciona una lista separada por comas de hosts a los que acceder directamente en su lugar. Para incluir varios hosts basados en un patrón común, utiliza el comodín *.
GROUNDRUNNER_CERT	Necesario si utilizas más de un GroundRunner y deseas enviar información encriptada al segundo GroundRunner. Esto debe utilizarse junto con PORT. También debes especificar el campo PROTOCOL como HTTPS al activar el corredor.
GROUNDRUNNER_CERT	Necesario si utilizas más de un GroundRunner y deseas recibir información encriptada de un segundo GroundRunner. Esto también debe utilizarse junto con PUERTO.
DISABLE_WEBSOCKETS	Se necesitan Websockets para ejecutar transformaciones. Al deshabilitarla, se omitirá por completo cualquier comando que utilice transformaciones.

Nota: Tu certificado autofirmado debe tener un Nombre alternativo del sujeto (SAN). Si no es así, cuando tu GroundRunner intente descargar archivos, mostrará un mensaje de error haciendo referencia a la SAN que falta.

Si tu red debe permitir dominios salientes, éstos se aplican a los GroundRunner:

Dominio	Propósito
`h.app.wdesk.com` `h.apac.wdesk.com` `h.ca.wdesk.com` `h.eu.wdesk.com`	Los principales subdominios de los servicios comunes de Workiva, incluido Wdata.
`*.wdesk.com`	El dominio principal de la plataforma de producción Workiva.
`..wdesk.com`	Los subdominios de los componentes de soporte de la plataforma Workiva.

Si no puedes usar comodines (*) para los permisos de lista de permitidos, usa el dominio "mothership" de tu región para permitir que se descarguen los recursos de GroundRunner y evitar posibles problemas de bloqueo en el futuro.

Dominio	Propósito
`mothership.app.wdesk.com` `mothership.apac.wdesk.com` `mothership.ca.wdesk.com` `mothership.eu.wdesk.com`	El subdominio para descargar los recursos de cadena requeridos.

Valor

Los GroundRunners nunca recopilan ni agregan datos: retienen datos solo durante la transmisión. Un certificado de validación ampliada (EV) siempre cifra y protege el tráfico entre un GroundRunner y su fuente de datos a través de DigiCert®.

Nota: Para proteger los datos locales, los CloudRunners pueden compartir resultados con los GroundRunners, pero los GroundRunners no pueden compartir resultados de archivos con CloudRunner.

Solucionar errores de GroundRunner

Si recibes estos errores cuando se ejecuta una cadena, comprueba los GroundRunner del comando.

Consejo: Para facilitar la resolución de problemas, puedes crear una cadena para que descargue automáticamente el archivo de registro de una unidad GroundRunner en una tabla.

Mensaje de error	Causa	Resolución
Se ha producido un error en la comunicación con el agente - este comando no se ha ejecutado	El comando no pudo comunicarse con su GroundRunner. Si esto ocurre, la unidad GroundRunner no se inició o se produjo una interrupción en la red entre la unidad GroundRunner y el Generador de cadenas.	Verifica: El servicio de GroundRunner funciona. El servidor del GroundRunner está conectado a Internet.
No se pueden descargar Recursos asociados al comando. Ponte en contacto con el Soporte técnico si el error persiste.	Los corredores asociados a los comandos de estas Cadenas no pueden comunicarse entre sí. Esto suele ocurrir cuando los comandos utilizan diferentes ejecutores y el CloudRunner está intentando utilizar un archivo de salida de un comando basado en GroundRunner.	Utiliza el mismo ejecutor con todos los comandos de la cadena. Si los comandos de la cadena requieren varios ejecutores, verifica que ningún comando con GroundRunner pase salidas de archivos a comandos que utilicen el CloudRunner.
Error al iniciar el comando: `exec: \"\[conector].exe\": el archivo no existe" commandExecutorId=[ID].`	Una aplicación de programas maliciosos (o antivirus) identificó incorrectamente el conector e interceptó su comunicación con el GroundRunner.	Excluye el directorio de instalación de GroundRunner de los análisis de la aplicación.
Errores en los certificados	Utilizar certificados autofirmados	En muchos casos, será conveniente utilizar certificados autofirmados para cifrar la comunicación de GroundRunner. Si utilizas un certificado autofirmado, asegúrate de que el Nombre Común del certificado coincide con la URL en la que se puede acceder al servidor. Por ejemplo, si tu GroundRunner está a la escucha en el puerto 8821 y puedes acceder al servidor desde tu red `localhost`, el Nombre Común del certificado sería "`localhost`".
Fallo intermitente de la cadena con error: "Restablecimiento de la conexión por el compañero".	Cuando se instalan varios corredores en la misma máquina, cada uno de ellos debe tener un GUID único. Si se utiliza el mismo GUID, los corredores pueden solaparse y entrar en un bucle de actualización, provocando fallos ocasionales en la cadena.	Recomendamos una reinstalación completa del GroundRunner.
Los comandos se omiten en GroundRunner pero tienen éxito en CloudRunner	Se necesitan Websockets para ejecutar transformaciones. Cuando los websockets estén deshabilitados, las transformaciones se omitirán por completo.	Abre tu archivo de configuración y establece `DISABLE_WEBSOCKETS=false`.
Se ha producido un error de lectura desde el socket. `Reintentando conexión: leer tcp <IP>:<Port>-><IP>:<Port>: wsarecv: Un intento de conexión ha fallado porque la parte conectada no ha respondido correctamente tras un periodo de tiempo, o la conexión establecida ha fallado porque el host conectado no ha respondido.`	Incidencia interna del cortafuegos o de la red	Pide a tu equipo interno de TI o de red que revise los registros y la configuración para resolver el error.
leer <IP>:<Port>-><IP>:<Port>: `wsarecv: El servidor remoto ha cerrado a la fuerza una conexión existente.`	Incidencia interna del cortafuegos o de la red	Pide a tu equipo interno de TI o de red que revise los registros y la configuración para resolver el error.

Recursos adicionales

Soporte técnico

Comunidad

Centro de soporte de Workiva