Classic file types are no longer available for use as of January 2021. You can transition your classic files or download a PDF. Learn More

Gestión de los GroundRunners para las conexiones

  • Last updated on

Para Habilitar los comandos dentro de una cadena para interactuar con una fuente de datos remota local, los administradores de TI o alguien familiarizado con la red de su organización y la configuración del firewall instalar y configurar un GroundRunner en un servidor dedicado, como donde aloja la fuente de datos conectada. Cuando se agrega un comando a una cadena, se asigna su conexión a un GroundRunner para realizar la tarea dentro del origen de datos.

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.

Requisitos previos

Los GroundRunners son compatibles con determinados sistemas operativos y requieren:

  • Java® versión 8
    Nota: GroundRunners actualmente sólo soporta Java versión 8, no versiones posteriores.
  • Recursos limitados del servidor

Para acceder a un recurso compartido, como una ruta de la Convención Universal de Nombres de Windows (UNC), el GroundRunner también necesita una cuenta de usuario con los privilegios adecuados para el recurso.

Java

Si es necesario, descargue Java de Oracle® o OpenJDK, e instálelo en la variable PATH para habilitar el acceso global a través de java en un símbolo del sistema. Después de instalar Java o editar su configuración, reinicie el servidor.

Nota: Al instalar Java, es posible que se le pregunte si desea instalar el Kit de desarrollo de Java (JDK) o el Entorno de ejecución de Java (JRE). Para GroundRunners, sólo se requiere el JRE.

Si utiliza un certificado autofirmado o no emitido por una autoridad de certificación, impórtelo en su almacén de claves Java para habilitar la seguridad Java/SSL:

  1. Obtenga de su administrador informático una copia del certificado utilizado para proteger su sitio web, o expórtelo desde su navegador.
  2. Copie el certificado en su instalación de GroundRunner.
  3. En su CLI, importe el certificado a su almacén de claves Java. Por ejemplo: 
    keytool -import -trustcacerts -keystore "C:\Program Files\Java\jre1.8.0_251\lib\security\cacerts" -storepass changeit -noprompt -alias [nombre del alias] -file [ruta_al_archivo_exportado].

Requisitos del sistema

GroundRunners soporta estos sistemas operativos, sin dependencias de librerías externas:

  • Microsoft Windows® Desktop 10, 32 y 64 bits
  • Microsoft Windows® Server 2012, 2012 R2, 2016, 2019 y 2022
  • Linux® Redhat y Ubuntu
  • macOS® Mojave o superior

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 de disco necesario, una cadena con cinco comandos que producen cada uno salidas efímeras de 10MB requiere 50MB 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)
Nota: 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®.

Cuenta de usuario

Por defecto, GroundRunners utiliza una cuenta administrativa local, con acceso inadecuado 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 distinta a la del administrador del sistema local por defecto, concédale permisos para gestionar el directorio de instalación del GroundRunner para habilitar las actualizaciones automáticas.

Descargar GroundRunners

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

  1. En Wdata, haga clic en Chain Builder.
  2. En Chain Builder, seleccione Settings en la barra lateral.
    iou.png
  3. Haga clic en Descargas en la parte superior.
    2022-07-14_11-41-37.png
  4. Busque el GroundRunner para su sistema operativo y haga clic en Descargar en el lado derecho.

Instalar canalizadores de tierra

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

Etapa 1. Instale el GroundRunner

Para utilizar un MSI para instalar un GroundRunner para Microsoft Windows Desktop o Windows Server con .NET 3.5 o superior:

  1. Descargar el GroundRunner, y descomprimir windows_amd64_ground_runner.zip.
  2. Para abrir el asistente de instalación de GroundRunner, ejecute GroundRunner.msi, y haga clic en Siguiente. groundrunner-msi_1.png
  3. Revise y acepte los términos del acuerdo de licencia y haga clic en Siguiente.
  4. Para Carpeta de destino, introduzca la ruta donde instalar el GroundRunner, como C:\Program Files\GroundRunner, y haga clic en Siguiente. groundrunner-msi_2.png
  5. En Plataforma token de empresa, introduzca su token de empresa.
    Nota: Para encontrar su ficha de empresa en Chain Builder, desde Admin ajustes, seleccione Runners ordenador, Descargas.
  6. 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 está en APAC, introduzca h.apac.wdesk.com/s/wdata/oc/app.
  7. Si utiliza un servidor proxy, realice una de las siguientes acciones:
    • Para acceder al servidor proxy, en Proxy host, introduzca su URL válida, incluyendo el puerto si es necesario. Por ejemplo, http://yourproxy:3000.
    • Para omitir el servidor proxy, en Ninguno proxy host, introduzca una Lista separada por comas de hosts a los que acceder directamente en su lugar.
  8. Haga clic en Siguiente, Instalar, y Finalizar. Si se le solicita el Control de cuentas de usuario, haga clic en Sí para habilitar el instalador para realizar cambios en su dispositivo.
  9. En el Administrador de servicios de Windows, haga clic con el botón derecho del ratón en GroundRunner, y seleccione Iniciar.

Etapa 2. Activar el GroundRunner

  1. En Chain Builder, seleccione Settings en la barra lateral.
    iou.png
  2. Haga clic en Runners en la parte superior.
  3. En Registro pendiente, introduzca un nombre corto y descriptivo para el corredor, como -GroundRunner
  4. Haga clic en Activar.
Nota: Para asegurar la integridad del ejecutable de GroundRunner, el instalador de Windows® está disponible para descargar y firmado criptográficamente por el equipo de Workiva Release Management como parte del ciclo de vida de desarrollo del software.

Para utilizar una interfaz de línea de comandos (CLI) para instalar un GroundRunner para Microsoft Windows Desktop o Windows Server:

Etapa 1. Descargar GroundRunner

  1. Descargue la instalación del GroundRunner a su propio directorio dentro de sus Archivos de programa, como c:\Program Files (x86)\wdata.
  2. Descomprima el Archivo de instalación y extraiga sus archivos a la raíz del directorio:
    • GroundRunner.exe
    • GroundRunnerMonitor.exe
    • installer.exe

Etapa 2. Instale el GroundRunner

  1. Desde la interfaz de línea de comandos de Windows (cmd.exe) (CLI), como administrador, ejecute el comando c:\Archivos de programa (x86)\wdata\installer.exe install, y acepte todos los valores predeterminados. managing-groundrunners-for-connections_1.png
    • Para la ruta, cree una carpeta Files dentro del nuevo directorio, como C:\Program Files (x86)\Wdata\Files. Seleccione esta opción para crearla si no existe.
    • 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.
    • Para la ficha de empresa, introduzca el valor generado para su organización.
      Nota: Para encontrar el ID de su empresa en Chain Builder, desde Admin ajustes, seleccione Runners ordenador, Descargas.
  2. Eliminar todos los archivos del directorio excepto el directorio ejecutable GroundRunner.
  3. Seleccione si desea ejecutar GroundRunner como un servicio o como un proceso en primer plano.
    • Si el 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 proceso en primer plano, en la CLI, introduzca los comandos: 
      cd c:\Archivos de programa (x86)\wdata GroundRunner.exe

Etapa 3. Activar el GroundRunner

  1. En Chain Builder, seleccione Settings en la barra lateral.
  2. Haga clic en Runners en la parte superior.
  3. En Registro pendiente, introduzca un nombre corto y descriptivo para el corredor, como -GroundRunner
  4. Haga clic en Activar.

Para instalar un GroundRunner en Linux o macOS:

Etapa 1. Instale el GroundRunner

  1. Descargar el Archivo de instalación del GroundRunner en su propio directorio, como /home//wdata/.
  2. En una interfaz de línea de comandos (CLI), descomprima el Archivo de instalación:
    • Para Linux, utilice el comando unzip linux_amd64_ground_runner.zip.
    • Para macOS, utilice el comando unzip darwin_amd64_ground_runner.zip.
  3. Introduzca los Detalles del GroundRunner.
    • Para Windows, utilice el comando ./installer install.
    • Para Mac OS, utilice el comando ./occli 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.
    • Para la ficha de empresa, introduzca el valor generado para su organización.
      Nota: Para encontrar el ID de su empresa en Chain Builder, desde Admin ajustes, seleccione Runners ordenador, Descargas.
  4. 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 comandos para ejecutar el GroundRunner como servicio en segundo plano o proceso en primer plano:

  • Si se ejecuta desde el programa de inicio del sistema operativo por defecto, se puede ejecutar como un servicio en segundo plano. Introducido: 
    /home/[nombredeusuario]/wdata/Contents/GroundRunnerMonitor
  • Para ejecutarlo como un proceso en primer plano con los registros escritos en la consola, introduzca: 
    cd home/[nombredeusuario]/wdata/Contents sudo ./GroundRunner.
  • Para ejecutarlo como un proceso en primer plano con los registros escritos en logfile, introduzca: 
    cd home/[username]/wdata/Contents sudo ./GroundRunnerMonitor
Consejo: Para detener un GroundRunner como proceso en primer plano, pulse CTRL + C.

Etapa 3. Activar el GroundRunner

  1. En Chain Builder, seleccione Settings en la barra lateral.
  2. Haga clic en Runners en la parte superior.
  3. En Registro pendiente, introduzca un nombre corto y descriptivo para el GroundRunner, como -GroundRunner.
  4. Haga clic en Activar.

Comprobar el Estado de un GroundRunner .

Los GroundRunners necesitan un latido constante para intercambiar mensajes con instrucciones sobre cómo ejecutar los trabajos y cualquier información relacionada. Si un GroundRunner se desconecta, ya no puede responder a los comandos y los administradores reciben un correo electrónico de advertencia.

Para ver el estado online/offline de un GroundRunner, en Chain Builder, desde Admin settings, Runners computer, ver qué runners están Pending Registration, Activada, o Inactive.

Nota: En caso de interrupción de la red, los GroundRunner intentan restablecer automáticamente la comunicación.

Para ver el estado de los recursos del sistema operativo host para un corredor, seleccione su Mostrar estado.

Nota: Para ver todos los GroundRunners activos en un servidor Linux, introduzca este comando en un CLI: ps -a |grep GroundRunner.

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.

  1. Descarga la última versión de GroundRunner para tu sistema operativo.
  2. En el Administrador de servicios de Windows, detenga el servicio GroundRunner.
  3. Mueva el archivo de instalación de GroundRunner descargado a su propio directorio-como c:\groundrunner_upgrade-y descomprima sus archivos.
  4. Copia y Pega estos archivos descomprimidos en el directorio donde están instalados los binarios de GroundRunner:
    • GroundRunner.exe o ocrunner.exe
    • GroundRunnerMonitor.exe o ocrunnermonitor.exe
  5. En el Administrador de servicios de Windows, reinicie el servicio GroundRunner.
  1. Descarga la última versión de GroundRunner para tu sistema operativo.
  2. En el servidor que aloja el GroundRunner, navegue hasta el directorio donde se ejecuta el servicio.
  3. En una CLI, detenga el servicio GroundRunner.
  4. Mueva el archivo de instalación de GroundRunner descargado a su propio directorio-como /home//groundrunner_upgrade/-y descomprima sus archivos.
  5. Copie y pegue estos archivos descomprimidos en el directorio donde están instalados los binarios de GroundRunner:
    • GroundRunner o ocrunner
    • GroundRunnerMonitor o ocrunnermonitor
  6. Para reiniciar el servicio GroundRunner, en la CLI, introduzca los comandos: 
    cd /home//wdata/Contents
    ./GroundRunner

Establecer los Entornos de un GroundRunner

Por defecto, los GroundRunners están disponibles en todos tus espacios de trabajo y Entornos. Para limitar el uso de un GroundRunner sólo a determinados Entornos:

  1. En Chain Builder, vaya a Settings, y luego seleccione Edit en el menú del GroundRunner.
    groundrunner-menu.png
  2. En Runner Restrictions, desmarque Global, y seleccione los espacios de trabajo y los entornos para utilizar el GroundRunner.
  3. Haz clic en Guardar.

Desinstalar un GroundRunner

Si ya no necesitas un GroundRunner, puedes desinstalarlo.

En Configuración de Windows, en Aplicaciones y características, seleccione GroundRunner (64 bits), y haga clic en Desinstalar.
  1. Detenga el servicio GroundRunner:
    • Si se ejecuta como un servicio , utilice el Administrador de servicios de Windows o, en la CLI, introduzca el comando sc stop GroundRunner.
    • Si se ejecuta como un proceso en primer plano , pulse la secuencia de teclas .
  2. En la CLI, como administrador, introduzca el comando installer.exe uninstall.
  3. Elimine el directorio ejecutable GroundRunner.

En la CLI, detenga el servicio GroundRunner, y elimine su directorio ejecutable, como en /home//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.

Nota: Los GroundRunners pueden usar servidores proxy, sólo no aquellos autenticados vía New Technology LAN Manager (NTLM). En su lugar, ponga en la lista blanca la dirección IP del servidor.
Configuración Configuración
PUERTO 0 a 65535. Por defecto, los GroundRunners utilizan el puerto 8821 para comunicarse entre sí. Sin embargo, se requiere un puerto sólo 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 arrendatario diferente.
LOG_LEVEL info o debug
PROTOCOLO Por defecto
HTTP_PROXY_URL Si utiliza un servidor proxy, su URL válida, incluido el puerto si es necesario. Por ejemplo, http://yourproxy:3000
LONG_POLL Si utiliza un servidor proxy, establezca true para indicar al ejecutor que utilice long-polling para recuperar comandos. Para garantizar el rendimiento, utilice sólo si su servidor proxy o cortafuegos no admite 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. También 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.
Tenga en cuenta que 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

h.app.wdesk.com

h.eu.wdesk.com

h.apac.wdesk.com

 Los principales subdominios para los servicios comunes de Workiva, incluyendo Wdata
*.wdesk.com El dominio principal de la plataforma de producción Workiva
*.*.wdesk.com Los subdominios para componentes de apoyo en la plataforma Workiva

Solucionar errores de GroundRunner

Si recibe estos errores cuando se ejecuta una cadena, compruebe los GroundRunners de los comandos:

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, el GroundRunner no se ha iniciado o se ha producido una interrupción de red entre el GroundRunner y Chain Builder. Verifícalo:
  • El servicio de GroundRunner está funcionando.
  • El servidor del GroundRunner está conectado a Internet.
No se pueden descargar los recursos asociados al comando. Contacta con el soporte técnico si el error persiste. Los corredores de los comandos de la cadena no pueden comunicarse entre sí. Esto sucede a menudo cuando los comandos utilizan diferentes ejecutores, y el CloudRunner intenta utilizar un archivo de salida de un comando con un GroundRunner.
Nota: Para proteger los datos locales, el CloudRunner puede compartir cualquier salida con los GroundRunners, pero los GroundRunners no pueden compartir salidas de archivos con el CloudRunner.
 Utilice el mismo runner con todos los comandos de la cadena, o-los comandos de la cadena requieren múltiples runners- verifique que ninguno de los comandos con GroundRunners pasa salidas de archivos a 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.

 

 

 
¿Fue útil este artículo?
Usuarios a los que les pareció útil: 4 de 10
Para Habilitar los comandos dentro de una cadena para interactuar con una fuente de datos remota local, los admini...