GroundRunners permite que los comandos de cadena interactúen con sistemas locales o fuentes de datos remotas a las que de otro modo no se podría acceder 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 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 de ruta de clase.
Nota: Para usar certificados personalizados con su instalación de Java, o simplemente para no usar las bibliotecas compartidas de Workiva, consulte nuestro artículo Uso de certificados personalizados con GroundRunners .
Descargar GroundRunner
Para descargar un GroundRunner para su instalación o actualización manual:
- En Chain Builder, seleccione Configuración en 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.
- Haga 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 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 está en América del Norte, ingrese
- 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 en 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.
Tu GroundRunner ya está instalado y listo para ser activado.
Para instalar a través de la interfaz de línea de comandos, debe descargar la instalación de GroundRunner a su propio directorio dentro de sus archivos de programa (como 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 instally 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
- Si está en América del Norte, ingrese
- Ingrese su token de empresa.
- Para la ruta, cree una carpeta Archivos dentro del nuevo directorio (por ejemplo,
- 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
- En la CLI, ingrese el comando
- Si se ejecuta como un proceso en primer plano, ingrese estos comandos en la CLI:
cd c:\Program Files (x86)\wdata GroundRunner.exe
- Si se ejecuta como servicio, realice una de las siguientes acciones:
Paso 1. Instalar 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, utilice el comando
unzip linux_amd64_ground_runner.zip - Para macOS, use el comando
unzip GroundRunner.zip
- Para Linux, utilice el comando
- Ingrese 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 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 está en América del Norte, ingrese
- Ingrese su token de empresa.
- Tanto para Linux como para Mac OS, utilice el comando
- 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/Contenidos/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 en la barra lateral.
- Haga clic en Corredores en la parte superior.
- En Registro pendiente, ingrese un nombre breve y descriptivo para el corredor (como <datasource> -Corredor de tierra).
- Haga clic en Activar.
Actualizar manualmente un GroundRunner
Aunque es poco común, es posible que necesites actualizar manualmente un GroundRunner.
Descargue e instale la última versión de 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/Contenidos
./GroundRunner
Desinstalar un GroundRunner
Si ya no necesitas GroundRunner, puedes desinstalarlo.
- 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>.
- Si se ejecuta como un servicio, utilice el Administrador de servicios de Windows o ingrese el comando
- 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, solo se requiere un puerto si los GroundRunners en diferentes servidores comparten salidas de comandos dentro de su red. |
| TOKEN DE EMPRESA | Déjelo como predeterminado, a menos que GroundRunner esté configurado para un inquilino diferente. |
| NIVEL DE REGISTRO | Información o depuración |
| PROTOCOLO | Dejar como predeterminado. |
| URL PROXY HTTP |
Si utiliza un servidor proxy, ingrese su URL y puerto (si es necesario). Por ejemplo, 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 utiliza 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 web sockets. |
| SIN PROXY | Para omitir el servidor proxy, proporcione una lista separada por comas de hosts a los que comunicarse 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 GROUNDRUNNER | Necesario si se utiliza más de un GroundRunner y se desea recibir información cifrada 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 haciendo referencia a la SAN faltante.
Si su red debe permitir dominios salientes, esto se aplica a GroundRunners:
| Dominio | Objetivo |
|---|---|
|
|
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 soportar componentes en la plataforma Workiva. |
Seguridad
GroundRunners nunca recopila ni agrega datos; retiene los 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 salidas 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, GroundRunner no se inició o se produjo una interrupción de la red entre GroundRunner y Chain Builder. |
Verificar:
|
| No se pueden descargar los recursos asociados con el comando. Comuníquese con el soporte si el error persiste. |
Los corredores asociados a los comandos de esta cadena 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 antivirus o malware 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 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, se omitirán por completo todas las transformaciones. |
Abra su archivo de configuración y establezca
|