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.
El Entorno de Ejecución de Java (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 .
Descargar el GroundRunner
Para descargar un GroundRunner para su instalación o actualización manual:
- En Chain Builder, seleccione Ajustes en la barra lateral.
- Haga clic en Descargas en la parte superior.
- Busca el GroundRunner para tu sistema operativo y haz clic en Descargar en la parte derecha.
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 acuerdo 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 , 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 está 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 se encuentra en Norteamérica, introduzca
- 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 Ninguno proxy host.
- Haga clic en Siguiente, Instalar, y Finalizar.
- Una vez instalado, haga clic con el botón derecho del ratón en el GroundRunner desde el Administrador de servicios de Windows y seleccione Iniciar.
Su GroundRunner ya está instalado y 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 instally 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 está 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 se encuentra en Norteamérica, introduzca
- Introduzca su código de empresa .
- Para la ruta, cree una carpeta Files dentro del nuevo directorio (como
- Eliminar todos los archivos del directorio excepto el directorio ejecutable 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
- En la CLI, introduzca el comando
- Si se ejecuta como un proceso en primer plano, introduzca estos comandos en la CLI:
cd c:\Archivos de programa (x86)\wdata GroundRunner.exe
- Si se ejecuta como un servicio, realice una de las siguientes acciones:
Etapa 1. Instale el GroundRunner
- Descargar el Archivo de instalación del GroundRunner en 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
- Para Linux, utilice el comando
- Introduzca los Detalles del GroundRunner.
- Tanto para Linux como para Mac OS, utilice el comando
<!--sudo -->./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 está 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 se encuentra en Norteamérica, introduzca
- Introduzca su código de empresa .
- Tanto para Linux como para Mac OS, utilice el comando
- Eliminar todos los archivos del directorio excepto el directorio ejecutable GroundRunner .
Etapa 2. Seleccione si desea que se ejecute como servicio o como proceso en primer plano.
En la CLI, introduzca los siguientes comandos para ejecutar el GroundRunner como un servicio en segundo plano o como un proceso en primer plano.
Servicio de fondo
Si se ejecuta desde el programa de inicio del sistema operativo por defecto, 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 el archivo de registro:
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 Ajustes en 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.
- Descarga la última versión de GroundRunner para tu sistema operativo.
- En Windows Services Manager, detenga el servicio GroundRunner.
- Mueva el archivo de instalación 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.
- Descarga la última versión de GroundRunner para tu sistema operativo.
- En el servidor que aloja el GroundRunner, vaya al directorio donde se ejecuta el servicio.
- En un 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.
- Detenga el servicio GroundRunner.
- Si se ejecuta como un servicio, utilice el Administrador de Servicios de Windows o introduzca el comando
sc stop GroundRunneren la CLI. - Si se ejecuta como proceso en primer plano, pulse la secuencia de teclas <ctrl> <c>.
- Si se ejecuta como un servicio, utilice el Administrador de Servicios de Windows o introduzca el comando
- En la CLI, como administrador, introduzca el comando
installer.exe uninstall. - Elimine 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 Habilitar la comunicación con su fuente de datos, puede que necesite 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 | Por defecto. |
| HTTP_PROXY_URL |
Si utiliza un servidor proxy, introduzca su URL y puerto (si es necesario). Por ejemplo, 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 en combinación 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 en combinación con PORT. |
| DISABLE_WEBSOCKETS | Los Websockets son necesarios para ejecutar transformaciones. Cuando está deshabilitado, cualquier comando que utilice transformaciones será omitido por completo. |
Nota: Su 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 su red debe permitir dominios salientes, estos se aplican a los GroundRunners:
| Dominio | Propósito |
|---|---|
|
|
Los subdominios principales de los servicios comunes de Workiva, incluido Wdata. |
*.wdesk.com |
El dominio principal para la plataforma Workiva de producción. |
*.*.wdesk.com |
Los subdominios de los 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 ampliada (EV) siempre encripta y protege el tráfico entre un GroundRunner y su origen de datos a través de DigiCert®.
Nota: Para proteger los datos locales, los CloudRunners pueden compartir la salida con los GroundRunners, pero los GroundRunners no pueden compartir la salida de archivos con CloudRunner.
Solucionar errores de GroundRunner
Si recibe estos errores cuando se ejecuta una cadena, compruebe los GroundRunners del comando.
Sugerencia: Para facilitar la solució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 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 el generador de cadenas. |
Verifícalo:
|
| No se pueden descargar los recursos asociados al comando. Contacta 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 el CloudRunner está intentando utilizar una salida de archivo de un comando basado en GroundRunner. |
Utiliza el mismo corredor con todos los comandos de la cadena. Si los comandos de la cadena requieren múltiples ejecutores, verifique que ninguno de los comandos con GroundRunners pase salidas de archivos a los comandos que utilizan 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 a 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: "Conexión restablecida por 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 -- causando fallos ocasionales en cadena. |
Recomendamos una reinstalación completa del GroundRunner.
|
| Los comandos se omiten en GroundRunner pero tienen éxito en CloudRunner | Los Websockets son necesarios para ejecutar transformaciones. Cuando los websockets están deshabilitados, las transformaciones se omiten por completo. |
Abrir el archivo de configuración y establecer
|