Instalar y gestionar los GroundRunners

Los GroundRunners permiten a los comandos en cadena interactuar con sistemas locales o fuentes de datos remotas a las que, de otro modo, no se podría acceder a través de Internet. Suelen instalarse en un servidor dedicado, como el que aloja su fuente de datos conectada, por un profesional de TI o alguien familiarizado con la configuración de red de su organización.

Antes de configurar un GroundRunner, recomendamos revisar la arquitectura de seguridad de Chain Builder.

Requisitos

Se necesita un sistema operativo compatible, y si su 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.

Java Runtime Environment (JRE) tiene licencia GPL v2, pero está cubierto por la excepción del classpath .

Nota: Para utilizar certificados personalizados con su instalación Java, o simplemente para no utilizar las bibliotecas compartidas de Workiva, consulte nuestro artículo Using custom certificates with GroundRunners .

En este momento, GroundRunners puede instalarse en las siguientes familias de sistemas operativos sin dependencias de bibliotecas externas:

Windows y Windows Server
macOS
Distribuciones Linux y derivados
RedHat, CentOS, Fedora, AmazonLinux
Debian/Ubuntu

Workiva se esfuerza por dar soporte a 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.

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 ayudar a calcular el espacio en disco necesario, sepa que una cadena con cinco comandos que producen cada uno salidas efímeras 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
8 GB de memoria del sistema
Un dispositivo de almacenamiento de estado sólido (SSD)

Este servidor debe estar disponible 24/7 para comunicarse con el GroundRunner.

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

Para acceder a un recurso compartido como una ruta UNC de Windows, inicie el GroundRunner bajo una cuenta de usuario con privilegios adecuados al recurso. Si utiliza una cuenta de usuario que no sea el administrador local del sistema por defecto, concédale permisos para gestionar el directorio de instalación del GroundRunner para permitir las actualizaciones automáticas.

Descargar el GroundRunner

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

En Chain Builder, seleccione Configuración configuraciónen la barra lateral.
Haga clic en Descargas en la parte superior.
Busque el GroundRunner para su sistema operativo y haga clic en Descargar en el lado derecho.

Instalar el GroundRunner

El instalador de Microsoft (MSI) requiere .NET 3.5 o superior. Si no puede cumplir este requisito, instale GroundRunner a través de la interfaz de línea de comandos.

Para instalar el GroundRunner:

Descomprima el archivo windows_amd64_ground_runner.zip .
Ejecute GroundRunner.msi para iniciar el asistente de instalación de GroundRunner.
Haga clic en Siguiente.
Revise y acepte los términos del contrato de licencia y haga clic en Siguiente.
Para la carpeta de destino, introduzca la ruta donde se instalará el GroundRunner (como 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:
- Si se encuentra en Norteamérica, introduzca h.app.wdesk.com/s/wdata/oc/app
- Si se encuentra en Europa, introduzca h.eu.wdesk.com/s/wdata/oc/app
- Si se encuentra en APAC, introduzca h.apac.wdesk.com/s/wdata/oc/app
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 No proxy host.
Haga 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.

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

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 (como c:\Program Files (x86)\wdata). A continuación, puede descomprimir el archivo de instalación y extraerlo en la raíz del directorio.

A continuación, puede instalar el GroundRunner :

Desde la CLI de Windows, ejecute el comando c:\Program Files (x86)\wdata\installer.exe install y acepte todos los valores predeterminados.
- Para la ruta, cree una carpeta Files dentro del nuevo directorio (como C:\Program Files (x86)\Wdata\Files).
- Para el nombre de host de autorización (AUTH_HOST):
  - Si se encuentra en Norteamérica, introduzca h.app.wdesk.com/s/wdata/oc/app
  - Si se encuentra en Europa, introduzca h.eu.wdesk.com/s/wdata/oc/app
  - Si se encuentra en APAC, introduzca h.apac.wdesk.com/s/wdata/oc/app
- Introduzca su código de empresa .
Borre todos los archivos del directorio excepto el directorio ejecutable de GroundRunner.
Seleccione si desea ejecutar GroundRunner como un servicio o como un proceso en primer plano.
- Si se ejecuta como un servicio, realice una de las siguientes acciones:
  - En la CLI, introduzca el comando sc start GroundRunner
  - En el Administrador de servicios de Windows, inicie el servicio HostRunner
- Si se ejecuta como un proceso en primer plano, introduzca estos comandos en la CLI:
```
cd c:\Program Files (x86)\wdata GroundRunner.exe
```

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

Paso 1. Instale el GroundRunner Instale el GroundRunner

Descargue el archivo de instalación del GroundRunner a su propio directorio, como /home/<username>/wdata/.
En una CLI, descomprima el archivo de instalación:
- Para Linux, utilice el comando unzip linux_amd64_ground_runner.zip
- Para macOS, utilice el comando unzip GroundRunner.zip
Introduzca los datos del GroundRunner.
- Tanto para Linux como para Mac OS, utilice el comando ./installer install
- Para el nombre de host de autorización (AUTH_HOST):
  - Si se encuentra en Norteamérica, introduzca h.app.wdesk.com/s/wdata/oc/app
  - Si se encuentra en Europa, introduzca h.eu.wdesk.com/s/wdata/oc/app
  - Si se encuentra en APAC, introduzca h.apac.wdesk.com/s/wdata/oc/app
- Introduzca su código de empresa .
Borre todos los archivos del directorio excepto el directorio ejecutable GroundRunner .

Segundo paso. Seleccione si desea que se ejecute como un servicio o como un proceso en primer plano

En la CLI, introduzca los siguientes comandos para ejecutar GroundRunner como servicio en segundo plano o como proceso en primer plano.

Servicio de fondo

Si se ejecuta desde el programa de inicio por defecto del sistema operativo, se puede ejecutar como un servicio en segundo plano:

/home/[nombredeusuario]/wdata/Contents/GroundRunnerMonitor

Proceso en primer plano

Para ejecutarlo como un proceso en primer plano con registros escritos en la consola:

cd home/[nombredeusuario]/wdata/Contents sudo ./GroundRunner

Para ejecutarlo como un proceso en primer plano con los registros escritos en logfile:

cd home/[nombredeusuario]/wdata/Contents sudo ./GroundRunnerMonitor

Activar el GroundRunner

Después de instalar su GroundRunner, debe activarlo en Chain Builder.

En Chain Builder, seleccione Configuración configuraciónen la barra lateral.
Haga clic en Runners en la parte superior.
En Registro pendiente, introduzca un nombre corto y descriptivo para el corredor (como <datasource>-GroundRunner).
Haga clic en Activar.

Actualizar manualmente un GroundRunner

Aunque es poco frecuente, puede ser necesario actualizar manualmente un GroundRunner.

Descargue e instale el último MSI, y desinstale cualquier versión descargada anteriormente.

Descargue la última versión de GroundRunner para su sistema operativo.
En Windows Services Manager, detenga el servicio GroundRunner.
Mueva el archivo de instalación de GroundRunner descargado a su propio directorio-como c:\groundrunner_upgrade-y descomprima sus archivos.
Copie y pegue GroundRunner.exe y GroundRunnerMonitor.exe en el directorio donde están instalados los binarios de GroundRunner.
En Windows Services Manager, reinicie el servicio GroundRunner.

Descargue la última versión de GroundRunner para su sistema operativo.
En el servidor que aloja el GroundRunner, vaya al directorio donde se ejecuta el servicio.
En una CLI, detener el servicio GroundRunner.
Mueva el archivo de instalación de GroundRunner descargado a su propio directorio-como /home/<username>/groundrunner_upgrade/-y descomprima sus archivos.
Copie y pegue GroundRunner.exe y GroundRunnerMonitor.exe en el directorio donde están instalados los binarios de GroundRunner.
Para reiniciar el servicio GroundRunner, introduzca estos comandos en la CLI:
```
cd /home/<username>/wdata/Contents
./GroundRunner
```

Desinstalar un GroundRunner

Si ya no necesitas un GroundRunner, puedes desinstalarlo.

En Configuración de Windows, vaya a Aplicaciones y características, seleccione GroundRunner (64 bits), y haga clic en Desinstalar.

Detenga el servicio GroundRunner.
- Si se ejecuta como un servicio, utilice Windows Service Manager o introduzca el comando sc stop GroundRunneren la CLI.
- Si se ejecuta como proceso en primer plano, pulse la secuencia de teclas <ctrl> <c>.
En la CLI, como administrador, introduzca el comando installer.exe uninstall.
Borre el directorio ejecutable GroundRunner .

En la CLI, detenga el servicio GroundRunner y elimine su directorio ejecutable (por ejemplo, /home/<username>/wdata/Contents).

Ajustes de configuración de GroundRunner y dominios de salida

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

Configuración	Configuración
PUERTO	0 a 65535. Por defecto, los GroundRunners utilizan el puerto 8821 para comunicarse entre sí. Sin embargo, un puerto sólo es necesario si los GroundRunners en diferentes servidores comparten salidas de comandos dentro de su red.
NOMBRE_EMPRESA	Dejar por defecto, a menos que el GroundRunner esté configurado para un inquilino diferente.
LOG_LEVEL	Información o debug
PROTOCOLO	Dejar por defecto.
HTTP_PROXY_URL	Si utiliza un servidor proxy, introduzca su URL y el puerto (si es necesario). Por ejemplo, `http://yourproxy:3000` Nota: GroundRunners puede 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 se utiliza un servidor proxy, establecer a true para indicar al ejecutor que utilice long-polling para recuperar comandos. Para garantizar el rendimiento, utilice el sondeo largo sólo si el servidor proxy o el cortafuegos no admiten sockets web.
NO_PROXY	Para evitar el servidor proxy, proporcione una lista separada por comas de hosts a los que acceder directamente. Para incluir varios hosts basados en un patrón común, utilice el comodín * .
GROUNDRUNNER_CERT	Necesario si se utiliza más de un GroundRunner y se desea enviar información encriptada al segundo GroundRunner.Debe utilizarse junto con PORT. También debe especificar el campo PROTOCOL como HTTPS al activar el corredor.
GROUNDRUNNER_CERT_KEY	Necesario si se utiliza más de un GroundRunner y se desea recibir información encriptada de un segundo GroundRunner.También debe utilizarse junto con PORT.

Nota: Su certificado autofirmado debe tener un Subject Alternative Name (SAN). Si no lo hace, cuando su GroundRunner intente descargar archivos, mostrará un mensaje de error haciendo referencia a la SAN que falta.

Si su red debe permitir dominios salientes, estos se aplican a los GroundRunners:

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

Seguridad

GroundRunners nunca recopila ni agrega datos; sólo los conserva durante la transmisión. Un certificado de validación extendida (EV) siempre encripta 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 recibe estos errores cuando se ejecuta una cadena, compruebe los GroundRunners 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
No se ha podido establecer 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 ha iniciado o se ha producido una interrupción en la red entre la unidad GroundRunner y Chain Builder.	Verifícalo: El servicio de GroundRunner está funcionando. El servidor del GroundRunner está conectado a Internet.
No se han podido descargar los recursos asociados al comando. Póngase en contacto con el servicio de asistencia 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.	Utilice el mismo corredor con todos los comandos de la cadena. Si los comandos de la cadena requieren múltiples ejecutores, verifique que ningún comando con GroundRunners 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 malware o antivirus identificó incorrectamente el conector e interceptó su comunicación con el GroundRunner.	Excluya el directorio de instalación de GroundRunner de los escaneos de la aplicación.
Errores en los certificados	Uso de certificados autofirmados	En muchos casos, será conveniente utilizar certificados autofirmados para cifrar la comunicación GroundRunner. Si utiliza un certificado autofirmado, asegúrese de que el nombre común del certificado coincide con la URL en la que se puede acceder al servidor. Por ejemplo, si su GroundRunner está escuchando en el puerto 8821 y puede acceder al servidor desde su 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 ejecutores 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.

Recursos adicionales

Ayuda

Comunidad

Centro de aprendizaje

Soporte técnico