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 finalizada la instalación y cuando GroundRunner esté en funcionamiento, descargará automáticamente un JRE según sea necesario para ejecutar comandos que dependan 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 Linux y derivados:
- RedHat, Fedora, AmazonLinux
- Debian/Ubuntu
macOS (sólo 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) disponibles
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 la función

En la plataforma Workiva

En la plataforma Workiva, necesita un rol que le conceda acceso a la configuración de Chain Builder y la capacidad de gestionar Runners. Hay dos:

Propietario de la cadena: Esta es la función principal requerida. Los usuarios con este rol pueden acceder a la sección "Descargas" en Chain Builder para recuperar los últimos archivos de instalación de GroundRunner y gestionar la pestaña "Runners" para activar o monitorizar el servicio.
Administrador de seguridad de la cadena organizativa: Este rol de nivel organizativo también tiene autoridad para gestionar conexiones y corredores a través de múltiples espacios de trabajo.

En el servidor

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

Windows: Debe tener la capacidad de ejecutar el símbolo del sistema como administrador y acceder al Administrador de servicios de Windows (para detener y reiniciar el servicio GroundRunner).
Linux/macOS: Debe tener acceso sudo o root para mover los 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.

Como alternativa, puede hacer clic en el icono de perfil de usuario en la parte superior derecha, seleccionar Chains admin, y después Workplace Settings.
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 puede cumplir este requisito, tendrá que instalar GroundRunner utilizando la interfaz de línea de comandos.

Para instalar el GroundRunner:

Descomprime GroundRunner.zip en una carpeta nueva y ábrela.
Ejecute 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.
Para la carpeta de destino, introduzca la ruta donde se instalará el GroundRunner, (por ejemplo: C:\Program Files\GroundRunner) y haga clic en Siguiente.
En la plataforma , introduzca el código de la empresa 1 e introduzca el código de la empresa .
En Plataforma auth host:
- Para APAC, introduzca h.apac.wdesk.com/s/chains-reaper.
- Para Canadá, introduzca h.ca.wdesk.com/s/chains-reaper.
- Para EMEA, introduzca h.eu.wdesk.com/s/chains-reaper.
- Para Estados Unidos, Centroamérica y Sudamérica, introduzca h.app.wdesk.com/s/chains-reaper.
Si utiliza un servidor proxy, introduzca su URL y puerto en Proxy host.
(Por ejemplo, http://yourproxy:3000.)
Para omitir el servidor proxy, introduzca una lista de hosts separada por comas en Sin host proxy.
Haz clic en Siguiente, Instalar, y Finalizar.
Una vez instalado, haga clic con el botón derecho del ratón en GroundRunner desde el Administrador de servicios de Windows y seleccione Iniciar.

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

Para instalar a través de la interfaz de línea de comandos, debe descargar la instalación del GroundRunner a su propio directorio dentro de sus archivos de programa (por ejemplo c:\Program Files (x86)\wdata). A continuación, puedes descomprimir el archivo de instalación y extraerlo en la raíz de ese directorio.

A continuación, puede instalar el GroundRunner:

En la ventana de comandos de Windows, introduzca
```
c:\Program Files (x86)\wdata\installer.exe install
```
y acepte todos los valores predeterminados.
- Seleccione "windows" como sistema de inicio.
  
  Es necesario especificar que el GroundRunner funcione como un servicio de Windows para que sea compatible con las actualizaciones automáticas. GroundRunners sólo debe ejecutarse como un servicio, excepto con fines de prueba.
- Para la ruta, cree 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, introduzca h.apac.wdesk.com/s/chains-reaper.
  - Para Canadá, introduzca h.ca.wdesk.com/s/chains-reaper.
  - Para EMEA, introduzca h.eu.wdesk.com/s/chains-reaper.
  - Para Estados Unidos, Centroamérica y Sudamérica, introduzca h.app.wdesk.com/s/chains-reaper.
- Introduzca su código de 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 diálogo de comandos, introduzca sc start GroundRunner.
  - En el Administrador de servicios de Windows, inicie el servicio GroundRunner.
- Si se ejecuta como un proceso en primer plano, en el cuadro de diálogo de comandos introduzca:
```
cd c:\Program Files (x86)\wdata GroundRunner.exe
```

Su GroundRunner está ahora instalado y listo para su activación.

Paso 1. Instalar el GroundRunner

Descargue el archivo de instalación del GroundRunner en su propio directorio,
por ejemplo: /home/nombre_usuario/wdata/.

Nota: "/home/nombre_usuario/wdata" se proporciona como ejemplo. Siga la política de su organización en cuanto a los lugares de instalación del servicio.
En un cuadro de diálogo de comandos, descomprima el archivo de instalación utilizando:
```
unzip GroundRunner.zip
```
Introduce los datos del GroundRunner.
1. Introduzca ./installer install
2. Para el nombre de host de autorización (AUTH_HOST):
  - Para APAC, introduzca h.apac.wdesk.com/s/chains-reaper.
  - Para Canadá, introduzca h.ca.wdesk.com/s/chains-reaper.
  - Para EMEA, introduzca h.eu.wdesk.com/s/chains-reaper.
  - Para Estados Unidos, Centroamérica y Sudamérica, introduzca h.app.wdesk.com/s/chains-reaper.
3. Introduzca su código de empresa .
Borre todos los archivos del directorio excepto la carpeta que se creó durante el proceso de instalación.

Segundo paso. Configure su GroundRunner como un servicio systemd (Linux)

Para asegurar que las actualizaciones automáticas de GroundRunner funcionen, y para una buena higiene de GroundRunner, GroundRunner necesita ser instalado como un servicio systemd habilitado y reiniciable. Por favor, consulte la documentación de su sistema operativo y la política de la organización acerca de cómo ejecutar el GroundRunner como un servicio systemd.

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

Asegúrese de que el ejecutable ExecStart apunta al binario GroundRunnerMonitor y NO al binario
GroundRunner.
Configurar Restart=always.
No configure StartLimitBurst o StartLimitIntervalSec, ya que pueden impedir que el GroundRunner se reinicie debido a errores transitorios. Si desea que el GroundRunner no entre en un bucle de reinicio rápido, puede configurar RestartSec.
Introduzca systemctl enable para habilitar la unidad de servicio GroundRunner systemd para que el GroundRunner sobreviva a un reinicio.

Workiva no soporta oficialmente la ejecución de 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 en segundo plano de larga duración.

Funcionamiento de GroundRunners en macOS (sólo pruebas)

Workiva es compatible con GroundRunners en macOS sólo con fines de prueba. Aunque los GroundRunners de macOS son capaces de ejecutar los mismos comandos que las versiones de Linux y Windows, Workiva no admite oficialmente launchd como gestor de servicios válido. Esto se debe a que Apple dejó de dar soporte a su software de servidor macOS en 2022. Los ordenadores portátiles y de sobremesa de Apple no son adecuados 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.
Introduzca un nombre corto y descriptivo para el corredor.
Por ejemplo, "<fuente de datos>-GroundRunner".
Haz clic en Activar.

Actualiza manualmente un GroundRunner

Aunque rara vez es necesario, es posible que tengas que actualizar manualmente un GroundRunner.
Consulte la página de soporte de Workiva GroundRunner Manual update para obtener instrucciones sobre cómo hacerlo.

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 un servicio, utilice el Administrador de Servicios de Windows, o escriba
  sc stop GroundRunner en una ventana de comandos.
- Si se está ejecutando como proceso en primer plano, pulsa Ctrl+C.
En el cuadro de diálogo de comandos, como administrador, escriba
installer.exe uninstall.
Elimina el directorio ejecutable GroundRunner.

En el cuadro de diálogo de comandos, detenga el servicio GroundRunner y elimine 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 las 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, permita 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 lo hace, cuando su GroundRunner intente descargar archivos, mostrará un mensaje de error haciendo referencia al SAN que falta.

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

Dominio	Propósito
`h.apac.wdesk.com` `h.app.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.

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 salidas con los GroundRunners, pero los GroundRunners no pueden compartir salidas 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, puede crear una cadena para descargar automáticamente el archivo de registro de un GroundRunner a 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: "Connection reset by peer"	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.	Abra su archivo de configuración y establezca `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