Instalar y administrar GroundRunners

GroundRunners permite que los comandos en cadena interactúen con sistemas locales o fuentes de datos remotas a las que de otro modo no serían accesibles a través de Internet. Generalmente, un profesional de TI o alguien familiarizado con la configuración de red de su organización los instala en un servidor dedicado, como el que aloja su fuente de datos conectada.

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

Requisitos

Se requiere un sistema operativo compatible y, si su GroundRunner accederá a recursos compartidos, como una ruta de Convención de nomenclatura universal (UNC) de Windows, también se necesitará una cuenta de usuario con privilegios suficientes.

El entorno de ejecución de Java (JRE) tiene licencia GPL v2 pero está cubierto por la excepción de ruta de clase.

Nota: Para usar certificados personalizados con su instalación de Java, o simplemente no usar las bibliotecas compartidas de Workiva, consulte nuestro artículo Uso de certificados personalizados con GroundRunners .

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

Windows y Windows Server
macOS
Distribuciones de Linux y derivados
Red Hat, Fedora, Amazon Linux
Debian/Ubuntu

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

Nota: El cronograma de soporte de cada sistema operativo lo establece el proveedor individual. 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

Si bien GroundRunners requiere recursos de servidor limitados, recomendamos al menos:

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

Nota: Para ayudar a calcular el espacio en disco requerido, tenga en cuenta que una cadena con cinco comandos que producen salidas efímeras de 10 MB cada uno 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 GroundRunners.
8 GB de memoria del sistema
Un dispositivo de almacenamiento de unidad de estado sólido (SSD)

Este servidor debe estar disponible las 24 horas del día, los 7 días de la semana para comunicarse con GroundRunner.

De forma predeterminada, GroundRunners utiliza 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 GroundRunner con una cuenta de usuario con privilegios adecuados para el recurso. Si utiliza una cuenta de usuario distinta del administrador del sistema local predeterminado, otórguele permisos para administrar el directorio de instalación de GroundRunner para habilitar actualizaciones automáticas.

Descargar 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 GroundRunner para su sistema operativo y haga clic en Descargar en el lado derecho.

Instalar GroundRunner

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

Para instalar GroundRunner:

Descomprima el archivo windows_amd64_ground_runner.zip .
Ejecute GroundRunner.msi para iniciar el Asistente de instalación de GroundRunner.
Haz clic en Siguiente.
Revise y acepte los términos del acuerdo de licencia y haga clic en Siguiente.
Para la Carpeta de Destino, ingrese la ruta donde se instalará GroundRunner (por ejemplo, C:\Program Files\GroundRunner\) y haga clic en Siguiente.
En Token de la empresa de la plataforma, ingrese su token de la empresa.
En el host de autenticación de la plataforma:

Si está en América del Norte, ingrese h.app.wdesk.com/s/wdata/oc/app

Si está en Europa, ingrese h.eu.wdesk.com/s/wdata/oc/app

Si está en APAC, ingrese h.apac.wdesk.com/s/wdata/oc/app
Si utiliza un servidor proxy, ingrese su URL y puerto en Host proxy. (Por ejemplo, http://yourproxy:3000.)
- Para omitir el servidor proxy, ingrese una lista de hosts separados por comas debajo de Sin host proxy.
Haga clic en Siguiente, Instalary Finalizar.
Una vez instalado, haga clic derecho en GroundRunner desde el Administrador de servicios de Windows y seleccione Iniciar.

Su GroundRunner ya se ha 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 de GroundRunner en su propio directorio dentro de sus archivos de programa (por ejemplo, c:\Program Files (x86)\wdata). Luego puedes descomprimir el archivo de instalación y extraerlo a la raíz del directorio.

Luego puedes instalar 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 Archivos dentro del nuevo directorio (por ejemplo, C:\Program Files (x86)\Wdata\Files).
- Para el nombre de host de autorización (AUTH_HOST):
  - Si está en América del Norte, ingrese h.app.wdesk.com/s/wdata/oc/app
  - Si está en Europa, ingrese h.eu.wdesk.com/s/wdata/oc/app
  - Si está en APAC, ingrese h.apac.wdesk.com/s/wdata/oc/app
- Ingrese su token de empresa.
Elimina todos los archivos del directorio excepto el directorio ejecutable de GroundRunner.
Seleccione si desea ejecutar GroundRunner como un servicio o un proceso en primer plano.
- Si se ejecuta como servicio, realice una de las siguientes acciones:
  - En la CLI, ingrese 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, ingrese estos comandos en la CLI:
```
cd c:\Program Files (x86)\wdata GroundRunner.exe
```

Su GroundRunner ya se ha instalado y está listo para ser activado.

Paso 1. Instalar el GroundRunner

Descargue el archivo de instalación de GroundRunner en su propio directorio, como /home/<username> /wdata/.
En una CLI, descomprima el archivo de instalación:
- Para Linux, use el comando unzip linux_amd64_ground_runner.zip
- Para macOS, use el comando unzip GroundRunner.zip
Ingrese los detalles 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 está en América del Norte, ingrese h.app.wdesk.com/s/wdata/oc/app
  - Si está en Europa, ingrese h.eu.wdesk.com/s/wdata/oc/app
  - Si está en APAC, ingrese h.apac.wdesk.com/s/wdata/oc/app
- Ingrese su token de empresa.
Elimina todos los archivos del directorio excepto el directorio ejecutable GroundRunner .

Paso 2. Seleccione si desea ejecutarlo como servicio o como proceso en primer plano.

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

Servicio en segundo plano

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

/home/[nombre de usuario]/wdata/Contenido/GroundRunnerMonitor

Proceso de primer plano

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

cd home/[nombre de usuario]/wdata/Contenido sudo ./GroundRunner

Para ejecutarlo como un proceso en primer plano con registros escritos en el archivo de registro:

cd home/[nombre de usuario]/wdata/Contenido sudo ./GroundRunnerMonitor

Activar el GroundRunner

Después de instalar tu GroundRunner, debes activarlo dentro de Chain Builder.

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

Actualizar manualmente un GroundRunner

Aunque es poco común, es posible que necesites mejorar manualmente un GroundRunner.

Descargue e instale la última versión MSI y desinstale cualquier versión descargada previamente.

Descargue la última versión de GroundRunner para su sistema operativo.
En el Administrador de servicios de Windows, detenga el servicio GroundRunner.
Mueva el archivo de instalación de GroundRunner descargado a su propio directorio (por ejemplo, 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 el Administrador de servicios de Windows, reinicie el servicio GroundRunner.

Descargue la última versión de GroundRunner para su sistema operativo.
En el servidor que aloja GroundRunner, vaya al directorio donde se ejecuta el servicio.
En una CLI, detiene 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, ingrese estos comandos en la CLI:
```
cd /home/<username> /wdata/Contenido
./GroundRunner
```

Desinstalar un GroundRunner

Si ya no necesitas GroundRunner, puedes desinstalarlo.

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

Detener el servicio GroundRunner.
- Si se ejecuta como un servicio, utilice el Administrador de servicios de Windows o ingrese el comando sc stop GroundRunneren la CLI.
- Si se ejecuta como un proceso en primer plano, presione la secuencia de teclas <ctrl><c>.
En la CLI, como administrador, ingrese el comando installer.exe uninstall.
Eliminar el directorio ejecutable GroundRunner .

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

Configuración de GroundRunner y dominios salientes

Para habilitar la comunicación con su fuente de datos, es posible que necesite abrir puertos de firewall en el servidor donde está instalado GroundRunner. Para cambiar la 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. De forma predeterminada, los GroundRunners utilizan el puerto 8821 para comunicarse entre sí. Sin embargo, un puerto solo es necesario si GroundRunners en diferentes servidores comparten salidas de comandos dentro de su red.
TOKEN DE LA EMPRESA	Déjelo como predeterminado, a menos que GroundRunner esté configurado para un inquilino diferente.
NIVEL DE REGISTRO	Información o depuración
PROTOCOLO	Déjalo como predeterminado.
URL DE PROXY HTTP	Si utiliza un servidor proxy, ingrese su URL y puerto (si es necesario). Por ejemplo, `http://yourproxy:3000` Nota: Los GroundRunners pueden usar servidores proxy, pero no aquellos autenticados a través de New Technology LAN Manager (NTLM). En su lugar, permita la dirección IP del servidor.
ENCUESTA LARGA	Si se usa un servidor proxy, configúrelo como verdadero para indicarle al ejecutor que utilice un sondeo largo para recuperar comandos. Para garantizar el rendimiento, utilice el sondeo largo solo si su servidor proxy o firewall no admite los sockets web.
SIN PROXY	Para omitir el servidor proxy, proporcione una lista de hosts separados por comas a los que se puede acceder directamente. Para incluir varios hosts según un patrón común, utilice el comodín * .
CERTIFICADO GROUNDRUNNER	Necesario si se utiliza más de un GroundRunner y se desea enviar información cifrada al segundo GroundRunner.Debe utilizarse junto con PORT. También debe especificar el campo PROTOCOLO como HTTPS al activar el ejecutor.
CLAVE DE CERTIFICADO DE GROUNDRUNNER	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.
DESACTIVAR WEBSOCKETS	Se requieren websockets para ejecutar transformaciones. Cuando está deshabilitado, cualquier comando que utilice transformaciones se omitirá por completo.

Nota: Su certificado autofirmado debe tener un nombre alternativo del sujeto (SAN). Si no es así, cuando GroundRunner intente descargar archivos, mostrará un mensaje de error que hace referencia al SAN faltante.

Si su red debe permitir dominios salientes, esto se aplica a GroundRunners:

Dominio	Objeto
`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 de producción Workiva.
`..wdesk.com`	Los subdominios para brindar soporte a los componentes en la plataforma Workiva.

Seguridad

GroundRunners nunca recopila ni agrega datos; retiene datos solo durante la transmisión. Un certificado de validación extendida (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 la salida con GroundRunners, pero GroundRunners no pueden compartir la salida de archivos con CloudRunner.

Solucionar errores de GroundRunner

Si recibe estos errores cuando se ejecuta una cadena, verifique GroundRunners del comando.

Consejo: Para facilitar la resolución de problemas, puede crear una cadena para descargar automáticamente un archivo de registro de GroundRunner a una tabla.

Mensaje de error	Causa	Resolución
No se pudo comunicar con el agente: este comando no se ejecutó	El comando no pudo comunicarse con su GroundRunner. Si esto sucede, el GroundRunner no se inició o se produjo una interrupción de la red entre el GroundRunner y Chain Builder.	Verificar: El servicio GroundRunner está funcionando. El servidor de GroundRunner está conectado a Internet.
No se pueden descargar los recursos asociados con el comando. Comuníquese con el soporte técnico si el error persiste.	Los corredores asociados a los comandos de estas cadenas no pueden comunicarse entre sí. Esto ocurre a menudo cuando los comandos utilizan diferentes ejecutores y CloudRunner intenta utilizar una salida de archivo de un comando basado en GroundRunner.	Utilice el mismo corredor con todos los comandos de la cadena. Si los comandos de la cadena requieren varios ejecutores, verifique que ningún comando con GroundRunners pase salidas de archivos a comandos que usan CloudRunner.
Error al iniciar el comando: exec: \"\\[connector].exe\": el archivo no existe" commandExecutorId=[ID]	Una aplicación de malware o antivirus identificó incorrectamente el conector e interceptó su comunicación con GroundRunner.	Excluir el directorio de instalación de GroundRunner de los análisis de la aplicación.
Errores de certificado	Uso de certificados autofirmados	En muchos casos, será conveniente utilizar certificados autofirmados para cifrar la comunicación de GroundRunner. Si está utilizando un certificado autofirmado, asegúrese de que el Nombre común del certificado coincida 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 el error: "Conexión restablecida por el par"	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 ejecutores pueden superponerse y entrar en un bucle de actualización, lo que provoca fallas ocasionales en la cadena.	Recomendamos una reinstalación completa de GroundRunner.
Los comandos se omiten en GroundRunner pero tienen éxito en CloudRunner	Se requieren websockets para ejecutar transformaciones. Cuando los websockets están deshabilitados, cualquier transformación se omitirá por completo.	Abra su archivo de configuración y configure `DISABLE_WEBSOCKETS=false`.

Recursos adicionales

Soporte

Centro de soporte de Workiva