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 cuando el GroundRunner esté en funcionamiento, descargará automáticamente un JRE si es 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 JRE existentes si existen en el servidor.
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.
Requisitos del puesto
En la plataforma Workiva
En la plataforma Workiva, necesitas un rol que te permita acceder a la configuración de Chain Builder y gestionar los Runners. Hay dos:
- Responsable de la cadena:. Este es el puesto principal que se requiere. Los usuarios con este rol pueden acceder a la sección «Descargas» de Chain Builder para obtener los últimos archivos de instalación de GroundRunner y gestionar la pestaña «Runners» para activar o supervisar el servicio.
- Administrador de seguridad de la cadena de la organización: Este rol a nivel de organización también tiene la autoridad para gestionar conexiones y ejecutores en varios espacios de trabajo.
En el servidor
Dado que una «actualización manual» implica detener los servicios y sustituir archivos ejecutables en la máquina física o virtual en la que está instalado GroundRunner, el usuario debe disponer de privilegios de administrador en el servidor anfitrión.
- Windows: Debes poder 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: Debes tener sudo o acceso de 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.
También puedes hacer clic en el icono del perfil de usuario situado en la esquina superior derecha, seleccionar « » (Cadenas de administración) y, a continuación, « » (Configuración de Workplace). - 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 este requisito, tendrás que instalar GroundRunner mediante 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 el campo «Destination Folder» (Carpeta de destino), introduce la ruta donde se instalará GroundRunner (por ejemplo:
C:\Program Files\GroundRunner\) y haz clic en « » (Siguiente). - En , en el campo «Token de la empresa de la plataforma», introduce tu «Token de la empresa de ».
- En Plataforma auth host:
- Para la región de Asia-Pacífico (APAC), introduce
h.apac.wdesk.com/s/chains-reaper. - Para Canadá, introduce
h.ca.wdesk.com/s/chains-reaper. - Para la región EMEA, introduce
h.eu.wdesk.com/s/chains-reaper. - Para Estados Unidos, Centroamérica y Sudamérica, introduce
h.app.wdesk.com/s/chains-reaper.
- Para la región de Asia-Pacífico (APAC), introduce
- Si utilizas un servidor proxy, introduce su URL y su puerto en , en el campo «Proxy host» ().
(Por ejemplo,, http://yourproxy:3000,.)
Para evitar el servidor proxy, introduce una lista de hosts separados por comas en « » (Sin servidor proxy). - Haz clic en Siguiente, Instalar, y Finalizar.
- Una vez instalado, haz clic con el botón derecho del ratón en «GroundRunner» en el Administrador de servicios de Windows y selecciona « » (Iniciar).
Tu GroundRunner ya ha sido instalado y está listo para ser activado.
Para realizar la instalación a través de la interfaz de línea de comandos, debes descargar el archivo de instalación de GroundRunner en un directorio propio dentro de la carpeta «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, puedes instalar GroundRunner:
-
En la ventana de comandos de Windows, escribe
c:\Archivos de programa (x86)\wdata\installer.exe instally acepta todos los valores predeterminados.
-
Selecciona «Windows» como sistema de inicio.
Debes especificar que GroundRunner debe funcionar como un servicio de Windows para que sea compatible con las actualizaciones automáticas. GroundRunners solo debe ejecutarse como servicio, salvo 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 la región de Asia-Pacífico (APAC), introduce
h.apac.wdesk.com/s/chains-reaper. - Para Canadá, introduce
h.ca.wdesk.com/s/chains-reaper. - Para la región EMEA, introduce
h.eu.wdesk.com/s/chains-reaper. - Para Estados Unidos, Centroamérica y Sudamérica, introduce
h.app.wdesk.com/s/chains-reaper.
- Para la región de Asia-Pacífico (APAC), introduce
- Introduce el token de tu empresa de :.
-
- 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, escribe «
sc start GroundRunner». - En el Administrador de servicios de Windows, inicia el servicio « GroundRunner».
- En el cuadro de diálogo de comandos, escribe «
-
Si se ejecuta como proceso en primer plano, introduce lo siguiente en el cuadro de diálogo de comandos:
cd c:\Archivos de programa (x86)\wdata GroundRunner.exe
- Si se ejecuta como servicio, haz una de las siguientes cosas:
Tu GroundRunner ya está instalado y listo para su activación.
Paso 1. Instalar el GroundRunner
-
Descarga el archivo de instalación de GroundRunner en un directorio propio,
, por ejemplo:/home/user_name/wdata/.Nota: «/home/user_name/wdata» se ofrece a modo de ejemplo. Sigue la política de tu organización en lo que respecta a los lugares de instalación del servicio.
-
En una ventana de comandos, descomprime el archivo de instalación con el siguiente comando:
Descomprime el archivo GroundRunner.zip - Introduce los datos del GroundRunner.
- Escribe «
./installer install» - Para el nombre de host de autorización (AUTH_HOST):
- Para la región de Asia-Pacífico (APAC), introduce
h.apac.wdesk.com/s/chains-reaper. - Para Canadá, introduce
h.ca.wdesk.com/s/chains-reaper. - Para la región EMEA, introduce
h.eu.wdesk.com/s/chains-reaper. - Para Estados Unidos, Centroamérica y Sudamérica, introduce
h.app.wdesk.com/s/chains-reaper.
- Para la región de Asia-Pacífico (APAC), introduce
- Introduce el token de tu empresa de :.
- Escribe «
- 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 de systemd (Linux)
Para garantizar el correcto funcionamiento de las actualizaciones automáticas de GroundRunner y mantener una buena gestión del programa, es necesario instalar GroundRunner como un servicio de systemd habilitado y que se pueda reiniciar. Consulte la documentación de su sistema operativo y la política de la organización para saber cómo ejecutar GroundRunner como servicio de systemd.
Para las configuraciones básicas, estos son los requisitos del archivo de unidad de systemd necesarios 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
StartLimitBurstniStartLimitIntervalSec, ya que esto podría impedir que GroundRunner se reinicie debido a errores transitorios. Si deseas evitar que el GroundRunner entre en un bucle de reinicio rápido, puedes configurar `RestartSec`. - Escribe «
» y «systemctl enable» para habilitar la unidad de servicio de GroundRunner en systemd, de modo que GroundRunner se mantenga activo tras un reinicio.
Workiva no admite oficialmente la ejecución de un GroundRunner como proceso en primer plano. Esto puede resultar útil para probar una configuración, pero, una vez configurado un GroundRunner, debería configurarse como un proceso en segundo plano de larga duración.
Uso de GroundRunners en macOS (solo a modo de prueba)
Workiva es compatible con GroundRunners en macOS únicamente con fines de prueba. Aunque los GroundRunners de macOS pueden 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 ofrecer soporte para su software de servidor macOS en 2022. Los ordenadores portátiles y de sobremesa de Apple no son compatibles con 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.
- Introduce un nombre breve y descriptivo para el corredor.
Por ejemplo, «<datasource>-GroundRunner». - Haz clic en Activar.
Lista de comprobación para la configuración de GR
- ¿Estás ejecutando el ejecutable «GroundRunnerMonitor» de
(en lugar del ejecutable «GroundRunner» de)? - ¿Has configurado tu
GroundRunnerMonitorcomo un servicio a nivel del sistema que se pueda reiniciar?- Para Linux:
Systemd. - Para Windows:
Servicios de Windows.
- Para Linux:
- ¿Se reinicia tu servicio al reiniciar el sistema?
- En Linux: «
» systemctl enable. - En Windows: el tipo de inicio está configurado como «
» (Automático).
- En Linux: «
- ¿Utilizas un sistema operativo de servidor compatible?
- ¿Tienes activadas 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 asistencia de Workiva y la actualización del manual de GroundRunner para obtener instrucciones sobre cómo hacerlo.
Desinstalar un GroundRunner
Si ya no necesitas un GroundRunner, puedes desinstalarlo.
- Detén el servicio GroundRunner.
- Si se está ejecutando como servicio, utiliza el Administrador de servicios de Windows o escribe «
sc stop GroundRunner» en una ventana de comandos. - Si se está ejecutando como proceso en primer plano, pulsa Ctrl+C.
- Si se está ejecutando como servicio, utiliza el Administrador de servicios de Windows o escribe «
- En el cuadro de diálogo de comandos, como administrador, escribe «
installer.exe uninstall». - Elimina el directorio ejecutable
GroundRunner.
En la ventana de comandos, detén el servicio GroundRunner y elimina su directorio de ejecutables (por ejemplo, /home/<nombre de usuario>/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 . Desactiva 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). 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 | Objeto |
|---|---|
|
|
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. |
Seguridad
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:
|
| 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 |
| 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 estableceDISABLE_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. |