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

Instalar y administrar GroundRunners

  • Last updated on

GroundRunners permite que los comandos en cadena interactúen con sistemas locales o fuentes de datos remotas a las que no se puede acceder de otro modo a través de Internet. Por lo general, 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

Los GroundRunners requieren Java versión 8 y un sistema operativo compatible. Si GroundRunner accederá a recursos compartidos, como una ruta de la Convención de nomenclatura universal (UNC) de Windows, también se necesita una cuenta de usuario con privilegios suficientes.

GroundRunners sólo se puede ejecutar en Java versión 8.

La versión 8 de Java se puede descargar directamente desde Oracle® o OpenJDK. Una vez descargado, 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 su servidor.

Nota: Al instalar Java, es posible que se le pregunte si desea instalar Java Development Kit (JDK) o Java Runtime Environment (JRE). Para GroundRunners, solo se requiere el JRE.

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

  1. Comuníquese con su administrador de TI para obtener una copia del certificado utilizado para proteger su sitio o expórtelo desde su navegador.
  2. Copie el certificado a la instalación de su GroundRunner.
  3. En una 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 de alias] -file [ruta_al_archivo_exportado]

Descargar GroundRunner

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

  1. En Chain Builder, seleccione Configuración configuraciónen la barra lateral.
    iou.png
  2. Haga clic en Descargas en la parte superior.
    2022-07-14_11-41-37.png
  3. Busque 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 con este requisito, instale GroundRunner a través de la interfaz de línea de comandos.

Para instalar GroundRunner:

  1. Descomprima el archivo windows_amd64_ground_runner.zip.
  2. Ejecute GroundRunner.msi para iniciar el asistente de configuración de GroundRunner.
  3. Haga clic en Siguiente.
    groundrunner-msi_1.png
  4. Revise y acepte los términos del acuerdo de licencia y haga clic en Siguiente.
  5. Para la carpeta de destino, ingrese la ruta donde se instalará GroundRunner (como C:\Program Files\GroundRunner\) y haga clic en Siguiente.
    groundrunner-msi_2.png
  6. En Token de empresa de plataforma, ingrese su token de empresa.
  7. En Host de autenticación de plataforma:
    • Si está en Norteamérica, 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
  8. Si utiliza un servidor proxy, ingrese su URL y puerto en Host proxy. (Por ejemplo, http://tuproxy:3000.)
    • Para omitir el servidor proxy, ingrese una lista de hosts separados por comas en Sin host proxy.
  9. Haga clic en Siguiente, Instalary Finalizar.
  10. 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 la activación.

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

Luego puedes instalar GroundRunner:

  1. 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 (como C:\Program Files (x86)\Wdata\Files). 
    • Para el nombre de host de autorización (AUTH_HOST):
      • Si está en Norteamérica, 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.
  2. Elimine todos los archivos del directorio excepto el directorio ejecutable de GroundRunner.
  3. 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, 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 la activación.

Paso 1. Instale GroundRunner

  1. Descargue el archivo de instalación de GroundRunner en su propio directorio, como /home/ /wdatos/.
  2. En una CLI, descomprima el archivo de instalación:
    • Para Linux, use el comando descomprimir linux_amd64_ground_runner.zip
    • Para macOS, use el comando descomprimir GroundRunner.zip
  3. Ingrese los detalles del GroundRunner.
    • Tanto para Linux como para Mac OS, use el comando ./installer install
    • Para el nombre de host de autorización (AUTH_HOST):
      • Si está en Norteamérica, 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.
  4. Elimine todos los archivos del directorio excepto el directorio ejecutable GroundRunner.

Paso 2. Seleccione si ejecutar 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 como un proceso en primer plano.

Servicio en segundo plano

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

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

Proceso de primer plano

Para ejecutarlo como 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 un 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.

  1. En Chain Builder, seleccione Configuración configuraciónen la barra lateral.
    iou.png
  2. Haga clic en Corredores en la parte superior.
  3. En Registro pendiente, ingrese un nombre breve y descriptivo para el corredor (como -GroundRunner).
    2023-11-04_10-31-29.png
  4. Haga clic en Activar.

Actualizar manualmente un GroundRunner

Aunque es poco común, es posible que tengas que actualizar manualmente un GroundRunner.

Descargue e instale el MSI más reciente y desinstale las versiones descargadas anteriormente.

  1. Descargue la última versión de GroundRunner para su 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. Copie y pegue GroundRunner.exe y GroundRunnerMonitor.exe en el directorio donde están instalados los archivos binarios de GroundRunner.
  5. En el Administrador de servicios de Windows, reinicie el servicio GroundRunner.
  1. Descargue la última versión de GroundRunner para su sistema operativo.
  2. En el servidor que aloja GroundRunner, vaya al directorio donde se ejecuta el servicio.
  3. En una CLI,detiene el servicio GroundRunner.
  4. Mueva el archivo de instalación de GroundRunner descargado a su propio directorio, como /home/ /groundrunner_upgrade/—y descomprime sus archivos.
  5. Copie y pegue GroundRunner.exe y GroundRunnerMonitor.exe en el directorio donde están instalados los archivos binarios de GroundRunner.
  6. Para reiniciar el servicio GroundRunner, ingrese estos comandos en la CLI: 
    cd /home/ /wdata/Contenidos
    ./GroundRunner

Desinstalar un GroundRunner

Si ya no necesita un GroundRunner, puede desinstalarlo.

Desde Configuración de Windows, vaya a Aplicaciones y características, seleccione GroundRunner (64 bits)y haga clic en Desinstalar.
  1. Detenga el servicio GroundRunner.
    • Si se ejecuta como un servicio, use 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 .
  2. En la CLI, como administrador, ingrese el comando installer.exe uninstall.
  3. Elimine el directorio ejecutable GroundRunner.

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

Valores de 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 los ajustes de configuración de algunos GroundRunner, puede editar el archivo GroundRunner.configen el directorio donde están instalados los binarios.

Configuración Configuración
PUERTO

0 a 65535.

De forma predeterminada, los GroundRunner utilizan el puerto 8821 para comunicarse entre sí. Sin embargo, solo se requiere un puerto si GroundRunners en diferentes servidores comparten salidas de comandos dentro de su red.
COMPAÑÍA_TOKEN Déjelo como predeterminado, a menos que GroundRunner esté configurado para un inquilino diferente.
NIVEL DE REGISTRO Información o depuración
PROTOCOLO Déjelo como predeterminado.
HTTP_PROXY_URL

Si utiliza un servidor proxy, ingrese su URL y puerto (si es necesario). Por ejemplo, http://tuproxy:3000

Nota: GroundRunners puede utilizar servidores proxy, pero no aquellos autenticados a través de New Technology LAN Manager (NTLM). En su lugar, incluya en la lista blanca la dirección IP del servidor.
LONG_POLL Si usa un servidor proxy, configúrelo en verdadero para indicarle al ejecutor que use un sondeo largo para recuperar comandos. Para garantizar el rendimiento, utilice el sondeo prolongado solo si su servidor proxy o firewall no admite sockets web.
NO_PROXY Para omitir el servidor proxy, proporcione una lista de hosts separados por comas a los que acceder directamente. Para incluir varios hosts según un patrón común, utilice el comodín *.
GROUNDRUNNER_CERT

Necesario si utiliza más de un GroundRunner y desea enviar información cifrada al segundo GroundRunner.Debe usarse junto con PORT.

También debe especificar el campoPROTOCOLO como HTTPS al activar el ejecutor.
GROUNDRUNNER_CERT_KEY Necesario si utiliza más de un GroundRunner y desea recibir información cifrada de un segundo GroundRunner.También debe usarse junto con PORT.
Nota: Su certificado autofirmado debe tener un Nombre alternativo del sujeto (SAN). Si no es así, cuando su GroundRunner intente descargar archivos, mostrará un mensaje de error que hace referencia a la SAN faltante.

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

Dominio Objetivo

h.app.wdesk.com

h.eu.wdesk.com

h.apac.wdesk.com

 Los principales subdominios 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; retienen datos sólo 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, CloudRunners puede compartir resultados con GroundRunners, pero GroundRunners no puede compartir resultados de archivos con CloudRunner.

Solucionar problemas de errores de GroundRunner

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

Consejo: Para ayudar a 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:
  • El servicio de GroundRunner está funcionando.
  • El servidor de GroundRunner está conectado a Internet.
No se pueden descargar los recursos asociados con el comando. Comuníquese con Soporte si el error persiste.

Los corredores asociados con los comandos de esta cadena no pueden comunicarse entre sí.

Esto ocurre a menudo cuando los comandos usan diferentes ejecutores y CloudRunner intenta usar 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 varios ejecutores, verifique que ningún comando con GroundRunner pase salidas de archivos a comandos que usan CloudRunner.
Error al iniciar el comando: ejecutivo: \"\\[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 GroundRunner.  Excluya 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 elNombre 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 redlocalhost, elnombre comúndel certificado seríalocalhost.
Fallo de cadena intermitente con error:
"Restablecimiento de conexión por parte del 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 corredores pueden superponerse y entrar en un bucle de actualización, lo que provoca fallos ocasionales en la cadena.

Recomendamos una reinstalación completa de GroundRunner.

 

 

 

Recursos adicionales

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 4 de 10
GroundRunners permite que los comandos en cadena interactúen con sistemas locales o fuentes de datos remotas a las qu...