클래식 파일 유형은 2020 년 12 월 Flash가 종료되면서 지원이 중단됩니다. 중단을 방지하려면 파일을 다음 세대로 전환하십시오. 더 알아보기

연결을 위한 GroundRunner 관리

  • 마지막 업데이트:

체인 내 명령이 온-프레미스 원격 데이터 소스와 상호 작용할 수 있도록 IT 관리자 또는 조직의 네트워크 및 방화벽 설정에 익숙한 사람이 연결된 데이터 소스를 호스팅하는 위치와 같은 전용 서버에 GroundRunner를 설치하고 설정합니다. 체인에 명령을 추가할 때 해당 연결을 GroundRunner에 할당하여 데이터 소스 내에서 작업을 수행합니다.

팁: 문제 해결을 용이하게 하기 위해 테이블에 GroundRunner의 로그 파일을 자동으로 다운로드하는 체인을 작성할 수 있습니다.

시스템 요구 사항

GroundRunner에는 Java® 버전 8 이상이 필요합니다.

참고: Java를 설치할 때 JDK(Java Development Kit) 또는 JRE(Java Runtime Environment) 설치 여부를 묻는 메시지가 표시될 수 있습니다. GroundRunner의 경우에는 JRE만 필요합니다. PATH 변수에 Java를 설치하면 명령 프롬프트에서 java 명령을 통해 전역적으로 액세스할 수 있습니다. Java를 설치하거나 구성을 편집한 후에는 서버를 재부팅하십시오.

GroundRunner는 외부 라이브러리 종속성 없이 다음 운영 체제를 지원합니다.

  • Microsoft Windows® Desktop 10, 32비트 및 64비트
  • Microsoft Windows® Server 2012, 2012 R2, 2016 및 2019
  • Linux® Redhat 및 Ubuntu
  • macOS® Mojave 이상

GroundRunner에 필요한 서버 리소스는 제한적이지만 최소 권장 사항은 다음과 같습니다.

  • 512MB의 사용 가능한 RAM(Random Access Memory)
  • 100GB의 사용 가능한 디스크 공간
참고: 필요한 디스크 공간을 쉽게 계산할 수 있도록 각각 10MB의 임시 출력을 생성하는 5개 명령을 사용하는 체인을 완료하려면 50MB가 필요합니다.

권장 호스트 구성에는 다음과 같이 구성된 가상 머신이 포함됩니다.

  • 2～4개의 프로세서
  • 8GB 시스템 메모리
  • SSD(Solid State Drive) 저장 장치
참고: GroundRunner는 데이터를 수집 또는 집계하지 않으며 전송 중에만 데이터를 유지합니다. EV(확장 유효성 검사) 인증서는 항상 DigiCert®를 통해 GroundRunner와 데이터 소스 간의 트래픽을 암호화하고 보호합니다.

기본적으로 GroundRunner는 공유 드라이브와 같은 원격 리소스에 대한 부적절한 액세스 권한으로 로컬 관리 계정을 사용합니다. Windows UNC(Windows Universal Naming Convention) 경로와 같은 공유 리소스에 액세스하려면 리소스에 대한 적절한 권한이 있는 사용자 계정으로 GroundRunner를 시작합니다. 기본 로컬 시스템 관리자 이외의 사용자 계정을 사용할 경우, 자동 업데이트를 활성화하려면 GroundRunner의 설치 디렉토리 관리 권한을 부여하십시오.

GroundRunner 다운로드

설치 또는 수동 업데이트를 위해 GroundRunner를 다운로드하려면:

  1. 체인 에서 관리자 설정을 클릭합니다.
  2. Runner computer, 다운로드를 선택합니다.
    manage-groundrunners_03.png
  3. 운영 체제용 GroundRunner에서 다운로드를 클릭합니다.

GroundRunner 설치

참고: Microsoft Installer(MSI)를 사용하려면 .NET 3.5 이상이 필요합니다. 이 요구 사항을 충족할 수 없는 경우에는 명령줄 인터페이스(CLI)를 통해 GroundRunner를 설치하십시오.

1단계. GroundRunner 설치

MSI를 사용해서 .NET 3.5 이상이 설치된 Microsoft Windows Desktop 또는 Windows Server용 GroundRunner를 설치하려면:

  1. GroundRunner를 다운로드하고 windows_amd64_ground_runner.zip 압축을 풉니다.
  2. GroundRunner 설치 마법사를 열려면 GroundRunner.msi를 실행하고 다음을 클릭합니다.groundrunner-msi_1.png
  3. 라이센스 계약의 조항을 검토하고 동의한 후 다음을 클릭합니다.
  4. 대상 폴더는 GroundRunner를 설치할 경로(예: C:\Program Files\GroundRunner\)를 입력하고 다음을 클릭합니다.groundrunner-msi_2.png
  5. 플랫폼 회사 토큰은 회사 토큰을 입력합니다.
    참고: 체인 에서 회사 토큰을 찾으려면 관리자 설정을 클릭하고 Runner computer , 다운로드를 차례로 선택합니다.
  6. 플랫폼 인증 호스트에서:
    • 북미 지역은 h.app.wdesk.com/s/wdata/oc/app을 입력합니다.
    • 유럽은 h.eu.wdesk.com/s/wdata/oc/app을 입력합니다.
  7. 프록시 서버를 사용하는 경우 다음 중 하나를 수행하십시오.
    • 프록시 서버에 연결하려면 프록시 호스트에 유효한 URL(필요한 경우 포트 포함)을 입력합니다(예: http://yourproxy:3000).
    • 프록시 서버를 우회하려면 프록시 호스트 없음에 대신 직접 연결할 호스트의 목록을 쉼표로 구분하여 입력합니다.
  8. 다음, 설치, 마침을 클릭합니다. 사용자 계정 제어 여부를 묻는 메시지가 표시되면 예를 클릭하여 설치 프로그램이 장치를 변경할 수 있도록 설정합니다.
  9. Windows 서비스 관리자에서 GroundRunner를 마우스 오른쪽 버튼으로 클릭하고 시작을 선택합니다.

2단계. GroundRunner 활성화

  1. 체인 에서 관리를 클릭하고 Runner를 선택합니다.
  2. 보류 중인 등록 아래에 Runner를 설명하는 짧은 이름(예: <datasource>-GroundRunner)을 입력합니다.
  3. 활성화를 클릭합니다.
참고: GroundRunner 실행 파일의 무결성을 보장하기 위해 Windows® 설치 프로그램을 다운로드할 수 있으며 Workiva 릴리스 관리팀이 소프트웨어 개발 수명 주기의 일부로 암호화하여 서명합니다.

명령줄 인터페이스(CLI)를 사용하여 Microsoft Windows Desktop 또는 Windows Server용 GroundRunner를 설치하려면:

1단계. GroundRunner 다운로드

  1. GroundRunner 설치를 프로그램 파일 내 자체 디렉토리(예: 1c:\Program Files (x86)\wdata)에 다운로드합니다.
  2. 설치 파일의 압축을 풀고 해당 파일을 디렉토리의 루트에 추출합니다.
    • GroundRunner.exe
    • GroundRunnerMonitor.exe
    • installer.exe

2단계. GroundRunner 설치

  1. Windows 명령줄 인터페이스(cmd.exe)(CLI)에서 관리자 권한으로 c:\Program Files (x86)\wdata\installer.exe install 명령을 실행하고 모든 기본값을 적용합니다.management-groundrunners-for-connections_1.png
    • 경로는 새 디렉토리 내에 Files 폴더(예: C:\Program Files (x86)\Wdata\Files)를 만듭니다. 이 폴더가 없으면 폴더를 만들도록 선택합니다.
    • 인증 호스트 이름(AUTH_HOST):
      • 북미 지역은 h.app.wdesk.com/s/wdata/oc/app을 입력합니다.
      • 유럽은 h.eu.wdesk.com/s/wdata/oc/app을 입력합니다.
    • 회사 토큰은 조직에 대해 생성된 값을 입력합니다.
      참고: 체인 에서 회사 ID를 찾으려면 관리자 설정을 클릭하고 Runner computer , 다운로드를 차례로 선택합니다.
  2. GroundRunner 실행 가능 디렉토리를 제외한 디렉토리에서 모든 파일을 삭제합니다.
  3. GroundRunner를 서비스 또는 포그라운드 프로세스로 실행할지 여부를 선택합니다.
    • 서비스인 경우 다음 중 하나를 수행합니다.
      • CLI에서 sc start GroundRunner 명령을 입력합니다.
      • Windows 서비스 관리자에서 HostRunner 서비스를 시작합니다.
    • 포그라운드 프로세스인 경우 CLI에서 다음 명령을 입력합니다. 
      cd c:\Program Files (x86)\wdata
GroundRunner.exe

3단계. GroundRunner 활성화

  1. 체인 에서 관리를 클릭하고 Runner를 선택합니다.
  2. 보류 중인 등록 아래에 Runner를 설명하는 짧은 이름(예: <datasource>-GroundRunner)을 입력합니다.
  3. 활성화를 클릭합니다.

포그라운드 프로세스로 Linux 또는 macOS에 GroundRunner를 설치하려면:

1단계. GroundRunner 설치

  1. GroundRunner의 설치 파일을 자체 디렉토리(예: /home/<username>/wdata/)에 다운로드하고 파일의 압축을 풉니다.
  2. 명령줄 인터페이스(CLI)에서 명령을 입력합니다./installer 설치.
    • 인증 호스트 이름(AUTH_HOST):
      • 북미 지역은 h.app.wdesk.com/s/wdata/oc/app을 입력합니다.
      • 유럽은 h.eu.wdesk.com/s/wdata/oc/app을 입력합니다.
    • 회사 토큰은 조직에 대해 생성된 값을 입력합니다.
      참고: 체인 에서 회사 ID를 찾으려면 관리자 설정을 클릭하고 Runner computer , 다운로드를 차례로 선택합니다.
  3. GroundRunner 실행 가능 디렉토리를 제외한 디렉토리에서 모든 파일을 삭제합니다.
  4. CLI에서 다음 명령을 입력합니다. 
    cd Contents
 ./GroundRunner

2단계. GroundRunner 활성화

  1. 체인 빌더에서 관리자 설정을 클릭하고 Runner 컴퓨터를 선택합니다.
  2. 보류 중인 등록 아래에 GroundRunner를 설명하는 짧은 이름(예: <datasource>-GroundRunner)을 입력합니다.
  3. 활성화를 클릭합니다.

GroundRunner의 상태 확인

GroundRunner는 작업 실행 방법 및 관련 정보를 포함하는 메시지를 교환하기 위해 지속적인 하트비트가 필요합니다. GroundRunner가 오프라인 상태가 되면 더 이상 명령에 응답할 수 없으며 관리자는 경고 이메일을 받습니다.

GroundRunner의 온라인/오프라인 상태를 보려면 체인에서 관리자 settings , Runner computer를 클릭하고 보류 중인 등록 , 활성 또는 비활성 상태의 Runner를 확인합니다.

참고: 네트워크가 중단되는 경우 GroundRunner는 자동으로 통신을 다시 설정하려고 시도합니다.

Runner에 대한 호스트 운영 체제의 리소스 상태를 보려면 상태 표시를 선택합니다.

참고: Linux 서버의 모든 활성 GroundRunner를 보려면 CLI에서 ps -a |grep GroundRunner 명령을 입력합니다.

GroundRunner 수동 업데이트

드믄 경우지만 GroundRunner를 수동으로 업그레이드해야 할 수도 있습니다.

최신 MSI를 다운로드해서 설치하고 이전에 다운로드한 버전을 제거합니다.

  1. 운영 체제용 최신 GroundRunner를 다운로드합니다.
  2. Windows 서비스 관리자에서 GroundRunner 서비스를 중지합니다.
  3. 다운로드한 GroundRunner 설치 파일을 자체 디렉토리(예: c:\groundrunner_upgrade groundrunner_upgrade)로 이동하고 파일의 압축을 풉니 다.
  4. 압축을 푼 파일을 GroundRunner 바이너리가 설치된 디렉토리에 복사하여 붙여넣습니다.
    • GroundRunner.exe
    • GroundRunnerMonitor.exe
  5. Windows 서비스 관리자에서 GroundRunner 서비스를 다시 시작합니다.
  1. 운영 체제용 최신 GroundRunner를 다운로드합니다.
  2. GroundRunner를 호스팅하는 서버에서 서비스가 실행되는 디렉로리로 이동합니다.
  3. CLI에서 GroundRunner 서비스를 중지합니다.
  4. 다운로드한 GroundRunner 설치 파일을 자체 디렉토리(예: /home//groundrunner_upgrade/로 이동하고 파일의 압축을 풉니 다.
  5. 압축을 푼 파일을 GroundRunner 바이너리가 설치된 디렉토리에 복사하여 붙여넣습니다.
    • GroundRunner
    • GroundRunnerMonitor
  6. GroundRunner 서비스를 다시 시작하려면 CLI에서 다음 명령을 입력하십시오. 
    cd /home/<username>/wdata/Contents
    ./GroundRunner

GroundRunner 환경 설정

기본적으로 GroundRunner는 모든 작업 영역과 환경에서 사용할 수 있습니다. GroundRunner를 특정한 환경에서만 사용하려면:

  1. 체인 에서 관리자 설정을 클릭합니다.
  2. GroundRunner 메뉴에서 편집을 선택합니다.
    groundrunner-menu.png
  3. Runner 제한에서 전체를 선택 해제하고 GroundRunner를 사용할 작업 영역과 환경을 선택합니다.
  4. 저장을 클릭합니다.

GroundRunner 제거

GroundRunner가 더 이상 필요하지 않은 경우 제거할 수 있습니다.

Windows 설정의 앱 및 기능에서 GroundRunner(64비트)를 선택하고 제거를 클릭합니다.
  1. GroundRunner 서비스를 중지합니다.
    • 서비스로 실행 중인 경우 Windows 서비스 관리자를 사용하거나 CLI에서 sc stop GroundRunner 명령을 입력합니다.
    • 포그라운드 프로세스로 실행 중인 경우 키 시퀀스 <ctrl> <c>를 누릅니다.
  2. CLI에서 관리자 권한으로 installer.exe uninstall 명령을 입력합니다.
  3. GroundRunner 실행 가능 디렉토리를 삭제합니다.

CLI에서 GroundRunner 서비스를 중지하고 실행 가능한 디렉토리(예: /home/<username>/wdata/Contents)를 삭제합니다.

GroundRunner 구성 설정 및 아웃바운드 도메인

데이터 소스와의 통신을 활성화하려면 GroundRunner가 설치된 서버에서 방화벽 포트를 열어야 할 수 있습니다. 일부 GroundRunner의 구성 설정을 변경하려면 바이너리가 설치된 디렉토리에서 GroundRunner.config 파일을 편집하면 됩니다.

참고: GroundRunner는 NTLM(New Technology LAN Manager)을 통해 인증된 서버가 아닌 프록시 서버를 사용할 수 있습니다. 대신 서버의 IP 주소를 허용 목록에 추가합니다.
구성 설정
PORT 0 ~ 65535. 기본적으로 GroundRunner는 포트 8821을 사용하여 서로 통신합니다. 그러나 포트는 다른 서버의 GroundRunner가 네트워크 내에서 명령 출력을 공유하는 경우에만 필요합니다.
COMPANY_TOKEN GroundRunner가 다른 테넌트에 대해 구성되지 않은 경우 기본값으로 유지합니다.
LOG_LEVEL info 또는 debug
PROTOCOL 기본값으로 유지
HTTP_PROXY_URL 프록시 서버를 사용하는 경우 유효한 URL(필요한 경우 포트 포함)입니다(예: http://yourproxy:3000).
LONG_POLL 프록시 서버를 사용하는 경우 Runner가 롱-폴링을 사용하여 명령을 검색하도록 지시하려면 true로 설정합니다. 성능을 보장하기 위해, 롱-폴링은 프록시 서버 또는 방화벽이 웹 소켓을 지원하지 않는 경우에만 사용합니다.
NO_PROXY 프록시 서버를 우회하려면 대신 직접 연결할 호스트의 목록을 쉼표로 구분하여 제공합니다. 공통 패턴을 기반으로 하는 여러 호스트를 포함하려면 * 와일드카드를 사용합니다.

네트워크에서 아웃 바운드 도메인을 허용해야 하는 경우 다음 사항이 GroundRunner에 적용됩니다.

도메인 목적

h.app.wdesk.com

h.eu.wdesk.com

 Wdata를 포함한 일반적인 Workiva 서비스의 주요 하위 도메인
*.wdesk.com 프로덕션 Workiva 플랫폼의 기본 도메인
*.*.wdesk.com Workiva 플랫폼의 구성 요소를 지원하기 위한 하위 도메인
도움이 되었습니까?
10명 중 4명이 도움이 되었다고 했습니다.
체인 내 명령이 온-프레미스 원격 데이터 소스와 상호 작용할 수 있도록 IT 관리자 또는 조직의 네트워크 및 방화벽 설정에 익숙한 사람이 연결된 데이터 소스를 호스팅하는 위치와 같은 전용 서버에 Groun...