Quick Installation Guide on Windows Agent node

Salt Minion Install

  1. Installer Download: https://github.com/snetsystems/salt/releases/download/v3001.4-5/Salt-Minion-3001.4-Py3-x86-Setup.exe

  2. Salt-Minion-3001.4-Py3-x86-Setup.exe을 실행한 후, 아래 화면에서 Minion Name은 비워둡니다.

     

  3. 아래 화면이 나오면 “예(Y)”를 클릭합니다.

     

  4. Minion config 설정을 위해 minion 실행은 하지 않고 “Finish”를 클릭하여 종료합니다.

     

  5. Config Path: C:\salt\conf\minion (default salt root path: c:\salt)
    주의 아래 설정 파일에는 주석 포함하여 영문 외 2 Byte 문자(예, 한글, 일본어, 중국어 등)가 포함되지 않도록 주의해야 합니다.

    ## log_level ## # One of 'garbage', 'trace', 'debug', info', 'warning'(default), 'error', 'critical'. log_level: info master: <master ip address> id: <유일한 minion id 설정해야 하며, 생략 시, hostname = minion id> multiprocessing: False # The maximum number of bytes a single log file may contain before it is rotated. # A value of 0 disables this feature. # Currently only supported on Windows. # On other platforms, use an external tool such as 'logrotate' to manage log files. log_rotate_max_bytes: 314572800 #300MB # The number of backup files to keep when rotating log files. # Only used if log_rotate_max_bytes is greater than 0. # Currently only supported on Windows. # On other platforms, use an external tool such as 'logrotate' to manage log files. log_rotate_backup_count: 7

     

  6. 윈도우 서비스에서 salt-minion 시작.

     

  7. CloudHub Portal 로그인 →“Agent Configuration > Minions” 메뉴 화면에서 새로 등록된 minion을 Operation 버튼을 통해 “Accept”합니다.

Telegraf Install

윈도우 버전 설치에 관한 자세한 내용은 https://github.com/snetsystems/telegraf/blob/release-1.19-snet/docs/WINDOWS_SERVICE.md를 참고 바랍니다.

  1. Installer Download: https://github.com/snetsystems/telegraf/releases 에서 최신 버전의 telegraf-xxx_windows_amd64.zip를 다운로드 후 압축 해제 합니다.

  2. C:\Program Files\Telegraf 디렉터리를 만듭니다(다른 위치에 설치하는 경우 원하는 위치에 --config 매개변수를 지정하기만 하면 됩니다).

  3. telegraf.exetelegraf.conf 구성 파일을 C:\Program Files\Telegraf에 넣습니다.

  4. Windows 서비스 관리자에 서비스를 설치하려면 PowerShell에서 관리자 모드로 다음을 실행합니다(필요한 경우 파일 경로의 공백을 큰따옴표 ""로 묶을 수 있음).

    > C:\"Program Files"\Telegraf\telegraf.exe --service install
  5. telegraf.conf을 편집합니다.
    노트 Telegraf on Windows 설정에 관한 자세한 내용은 https://seversky.atlassian.net/wiki/spaces/CSHD/pages/1921679371 항목을 참고 바랍니다.

  6. 윈도우 서비스에서 “Telegraf Data Collector Service”를 시작합니다.

     

  7. 정상 작동 확인을 위해 아래와 같이 윈도우 이벤트 뷰어를 실행 > “사용자 지정 보기 만들기”를 설정합니다.

     

  8. 아래와 같이 적당한 이름을 넣고 [확인]을 클릭합니다.

     

  9. 아래 화면과 같이 에러 로그 등의 비정상 로그가 없다면 정상 작동 하고 있을 것 입니다.

 

설정한 Configuration에 대한 validation check를 위해 다음 실행할 수 있습니다.
> .\telegraf.exe --test --debug --config C:"Program Files"\Telegraf\telegraf.conf

단, 이 경우는 telegraf.conf에서 logtarget = "eventlog"# logtarget = "eventlog"로 주석 처리하고 위 명령을 실행해야 에러 로그 등이 정상 출력 됩니다.

주의 테스트가 끝난 후, 반드시 logtarget = "eventlog"로 다시 복원하여 주십시오.

Troubleshoot: 참고.