1 MSI를 이용한 Windows 에이전트 설치

개요

Zabbix agent는 다운로드할 수 있는 32비트 또는 64비트 MSI 설치 패키지를 사용하여 Windows에 설치할 수 있습니다.

MSI 설치를 위한 최소 OS 요구사항은 다음과 같습니다:

• Zabbix agent의 경우: Windows XP (64비트) 또는 Windows Server 2003
• Zabbix agent 2의 경우: Windows 10 (32비트) 또는 Windows Server 2016

32비트 패키지는 64비트 시스템에 설치할 수 없습니다.

패키지에 포함된 내용:

• TLS 지원 (TLS 구성은 선택사항)
• Zabbix get과 Zabbix sender 유틸리티 (Zabbix agent/agent 2와 함께 설치하거나 별도로 설치 가능)

설치는 설치 마법사 또는 명령줄을 사용하여 수행할 수 있습니다.

MSI 패키지를 사용한 설치가 완전히 지원되지만, 적절한 오류 처리를 위해 최소한 Microsoft .NET Framework 2를 설치하는 것이 권장됩니다.

설치 마법사를 통한 설치

다음 설치 단계는 Zabbix agent와 Zabbix agent 2 모두에 적용됩니다.

1. 다운로드한 MSI 파일을 더블 클릭하여 설치를 시작합니다:

2. 최종 사용자 라이선스 계약에 동의합니다:

3. 설치할 Zabbix 구성 요소(Agent daemon, Zabbix sender, Zabbix get)를 선택합니다:

4. 다음 매개변수를 구성합니다. 해당 값들은 Zabbix agent 구성 파일에 설정됩니다:

5. 이전 단계에서 Enable PSK 체크박스를 표시한 경우 PSK 매개변수를 구성합니다. 이러한 매개변수들도 Zabbix agent 구성 파일에 설정됩니다:

6. Install을 클릭하여 설치를 시작합니다.

선택된 모든 Zabbix 구성 요소와 Zabbix agent 구성 파일이 지정된 위치(기본값: C:\Program Files\Zabbix Agent)에 설치됩니다. Zabbix agent 2의 경우에도 동일하게 적용되지만, 내장 플러그인에 대한 추가 구성 파일이 zabbix_agent2.d\plugins.d 하위 폴더에 설치됩니다.

또한 zabbix_agentd.exe(또는 zabbix_agent2.exe)는 지연된 자동 시작(또는 Windows Vista/Server 2008 이전 Windows 버전에서는 자동 시작)으로 Windows 서비스로 설정됩니다.

설치 중에 다른 버전의 Zabbix agent가 실행 중인 경우, 애플리케이션을 닫고 재시작을 시도하거나 열어 둘지 선택하라는 메시지가 표시되며, 후자의 경우 재부팅이 필요합니다.

7. Finish 버튼을 클릭하여 설치 마법사를 종료합니다.

명령줄에서 설치

Zabbix agent는 msiexec를 사용하여 MSI 설치 프로그램을 실행하는 방식으로 명령줄에서 설치할 수 있습니다. 예를 들어:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.0

이 방법을 사용하면 매개변수를 활용하여 무인 설치와 사용자 정의 구성이 가능합니다.

지원되는 매개변수

Zabbix agent MSI 설치 패키지는 Zabbix agent와 Zabbix agent 2 모두에 대해 다음 매개변수를 지원합니다.

예제

다음 예제는 사용자 정의 구성으로 Zabbix agent를 설치합니다. 또한 사전 공유 키를 사용하여 TLS 지원을 활성화합니다.

mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.0-windows-amd64-openssl.msi" /qn+^
 SERVER=192.0.2.0^
 INSTALLFOLDER="C:\Program Files\Zabbix Agent"^
 HOSTNAME=LAPTOP-IKP7S51S^
 TLSACCEPT=psk^
 TLSCONNECT=psk^
 TLSPSKIDENTITY="PSK 001"^
 TLSPSKFILE="C:\Program Files\Zabbix Agent\psk.key"^
 TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952^
 ENABLEPATH=1^
 ALLOWDENYKEY="AllowKey=system.run[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]"

다음 예제는 Zabbix agent의 새로운 버전을 설치하고 템플릿 구성 파일을 사용합니다(CONF="C:\agent-template.conf"). 설치 중에 이 파일이 agent 구성 파일이 됩니다. 기존 구성 파일의 매개변수를 상속하려면 매개변수 자리 표시자(예: [AllowDenyKey])를 사용하십시오.

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.1-windows-amd64-openssl.msi" /qn+ CONF="C:\agent-template.conf"

# agent-template.conf 예제:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]

또는 사용자 정의 구성 파일을 사용할 수 있습니다(NONMSICONFNAME="C:\agent-custom.conf"). 설치 중에 이 파일에 있는 유효한 agent 구성 매개변수(위 표에 나열된 것으로 제한됨)는 새로 생성된 agent 구성 파일에 작성됩니다. 기존 agent 구성을 유지하려면 보존할 매개변수를 정의하십시오.

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"

# agent-custom.conf 예제:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B

Zabbix agent 2 loadable plugins

Zabbix agent 2 loadable plugins는 64비트 MSI 설치 패키지를 사용하여 Windows에 설치할 수 있으며, 다운로드가 가능합니다. Ember+ plugin은 Zabbix 7.0.10부터 이 패키지에 포함되어 있습니다.

MSI 설치를 위한 최소 OS 요구사항은 Windows 10 (64비트) 또는 Windows Server 2016입니다.

Zabbix agent/agent2와 마찬가지로 loadable plugins는 Setup Wizard 또는 명령줄을 사용하여 설치할 수 있습니다.

설치 마법사를 통한 설치

1. 다운로드한 MSI 파일을 더블클릭하여 설치를 시작합니다.

2. 최종 사용자 라이센스 계약에 동의합니다.

3. 설치할 Zabbix agent 2 로드 가능한 플러그인을 선택합니다.

4. 설치를 클릭하여 설치를 시작합니다.

선택한 모든 Zabbix agent 2 로드 가능한 플러그인이 지정한 위치(기본값: C:\Program Files\Zabbix Agent 2)에 설치되며, 해당 구성 파일은 zabbix_agent2.d 하위 폴더에 설치됩니다.

5. 완료 버튼을 클릭하여 설치 마법사를 종료합니다.

명령줄에서 설치

Zabbix agent 2 로드 가능한 플러그인은 msiexec를 사용하여 MSI 설치 프로그램으로 명령줄에서 설치할 수 있습니다. 예를 들어:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-7.0.0-windows-amd64.msi" /qn+

Zabbix agent 2 로드 가능한 플러그인 MSI 설치 프로그램 패키지는 다음 매개변수를 지원합니다.