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 설정에 관한 자세한 내용은 Telegraf Configuration 항목을 참고 바랍니다.

  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"로 다시 복원하여 주십시오.