본문으로 건너뛰기

httpd-_3.0.12이하

1. 패키지 설치 시 주의사항​

반드시 설치 전 Apache HTTPD의 버전을 확인합니다.

httpd -V

Linux & Solaris HTTPD 2.4 버전을 지원하며, 설치할 환경의 HTTPD 버전을 정확히 확인해야 합니다.

패키지 파일은 setup_exem-httpd-module_${VERSION}.bin 의 설치 파일로 배포되며 설치할 경로에서 실행합니다. 

1.1 설치 방법​

  • 설치할 타겟 HTTPD 버전을 확인합니다. ( httpd -V )
  • 패키지 설치를 진행할 경로에서 설치파일을 실행하고 install을 선택합니다. (엔터 입력 시 install)
정보

Unpack은 Package 내부에 구성된 파일들을 확인하는 용도로 사용

=====================================================
 EXEM HTTPD Module Setup 
=====================================================
choise work
1. unpack
2. install(default)
:
  • 설치할 타겟 HTTPD 버전을 입력합니다. (2.4)
=====================================================
exem-httpd-module v3.0.11(478b714) Install on sunos 5.10
=====================================================
Install HTTPD Version(2.4):

  • 설치 디렉토리를 입력합니다. (엔터 입력 시 기본 경로에 설치)
Install Directory (/path/to/httpd-module):
  • 통신할 exem-webserver-agent의 IP를 입력합니다. (엔터 입력 시 기본 값 127.0.0.1 적용)
ExEm Connect IP(127.0.0.1)
  • 통신할 exem-webserver-agent의 Port를 입력합니다. (엔터 입력 시 기본 값 10848 적용)
ExEm Connect Port(12848):
  • 모듈의 Group ID를 등록합니다. (엔터 입력 시 기본 값 default 적용)
Group ID to register(default):
  • webserver 모니터링 대상으로 등록 될 이름을 입력합니다. (엔터 입력 시 기본 값 서버의 HostName 적용)
(optional)Module Name to register(t41a):
  • exem-host-agent와 맵핑할 BID를 입력합니다. (엔터 입력 시 기본 값 서버의 HostName 적용)
EXEM BID with host agent(t41a)
  • 모듈이 사용할 설정 파일 이름을 입력합니다. (엔터 입력 시 기본 값 exem_httpd_mod.conf 적용)
httpd module config filename(exem_httpd_mod.conf):
  • agent ↔ module 간 사용 될 unique id를 고정할 지 선택합니다. 온프레미스 환경에서는 일반적으로 엔터를 눌러 기본으로 고정합니다. (엔터 입력 시 기본 값 yes 적용)
Do you want to fix the 'unique id'?[yes(default)/no]:
  • 설치 완료 문구 확인 (설정 적용 값)
Install Directory [/path/to/httpd-module] 
Connect IP to Agent [127.0.0.1] 
Connect Port to Agent [12848] 
Group ID [default] 
Module Name [t41a] 
Generated Unique ID [e619ae08-test-test-test-9c048e02a63f] 
=====================================================
Copy tools from tools/mdl-ver_sunos_64
Copy tools from tools/xm-uuidgen_sunos_64

+--> Add the following line to 'httpd.conf' >--+
# exem module
Include /path/to/httpd-module/conf/exem_httpd_mod.conf

Add the following line to 'httpd.conf' 이후에 나온 내용을 아래 내용 참고하여 httpd.conf 에 추가

1.2 httpd.conf 설정​

  • httpd.conf 파일 경로 확인
httpd -V
  • -D SERVER_CONFIG_FILE= 의 값 또는 HTTPD 설치 경로의 conf/httpd.conf 를 통해 httpd.conf 파일 경로를 확인
  • httpd.conf 파일을 열어서 설치 완료 시 출력된 Include 설정을 추가
# exem module
Include /path/to/httpd-module/conf/exem_httpd_mod.conf
정보

nginx 모듈과 달리 load_module 지시자를 별도로 추가할 필요가 없습니다. LoadModule 지시자가 exem_httpd_mod.conf 설정 파일 내에 포함되어 있습니다.

​

2. Silent 설치​

2.1 Default​

--default 옵션을 사용하여 group id를 default로 설정하고 나머지는 기본 설정으로 입력없이 설치가 가능합니다.

팁

--default 옵션을 사용하면 ExEmBID 설정은 hostname으로 자동 설정 됩니다.

$ ./setup_exem-httpd-module_3.0.5.bin --default
=====================================================
 EXEM HTTPD Module Setup 
=====================================================
SETUP TYPE[install]
unpack httpd modules
LOG_PATH[./setup_exem-httpd-module_3.0.5.log]
=====================================================
exem-httpd-module v3.0.5-debug(3723b7a) Install on linux 3.10
=====================================================

Install Directory [/home/webadmin/httpd/httpd-module] 
Group ID [default] 
Module Name [no input] 
Generated Unique ID [f563f7b4-test-test-test-c2a23173f743] 
=====================================================

+--> Add the following line to 'httpd.conf' >--+
# exem module
Include /home/webadmin/httpd/httpd-module/conf/exem_httpd_mod.conf

2.2 Silent​

silent 설정 파일을 통해 설치 과정에서 입력없이 설치가 가능합니다.

sample 파일 생성

$ ./setup_exem-httpd-module_3.0.11.bin --silent-sample

sample 파일 확인 및 작성

$ cat setup_default.silent 
SETUP_TYPE=install
INSTALL_HTTPD_VERSION=2.4
INSTALL_DIR=/path/to/httpd-module
GROUP_ID=default
#MODULE_NAME=
CONFIG_FILENAME=exem_httpd_mod.conf
FIX_UNIQUE_ID=yes
#EXEM_BID=

slient 설정 파일을 통해 설치

$ ./setup_exem-httpd-module_3.0.11.bin --silent=setup_default.silent

3. 설정 파일 (exem_httpd_mod.conf)​

설치 시 자동 생성되는 설정 파일의 구조는 다음과 같습니다. (예시)

############################################
### EXEM Httpd Module Configuration File ###

LoadModule exem_module /path/to/httpd-module/modules/mod_exem_24_{OSNAME}_64.so

<IfModule exem_module>

ExEmGroupID default
ExEmUniqueID {UUID}

# module name(defult: hostname)
#ExEmModuleName <input module_name>

# EXEMBID with host agent
ExEmBID {HOSTNAME}

# Send data(packet) logging
ExEmDump false

# default ip:127.0.0.1, port:12848
ExEmConnectIP 127.0.0.1
#ExEmConnectPort <input port>

# default 5 sec
ExEmConnectReconnectSec 5

# do not use 0(zero)
ExEmLogPath /path/to/httpd-module/log/mod_exem.log
ExEmLogLevel info

# default 10 Megabyte
ExEmLogMaxSize 10

# metrics configuration (default: 127.0.0.1:12849/exem/v1/metrics)
#ExEmMetricAddr 127.0.0.1:12849
#ExEmMetricLocation /exem/v1/metrics

# config for httpd
#Listen 12849
#<VirtualHost *:12849>
#<Location /exem/v1/metrics>
#  SetHandler exem-metrics
#</Location>
#</VirtualHost>

</IfModule>

[옵션] httpd metric을 수집하고 싶을 경우 설정해야 할 옵션​

  • metric을 수집하고 싶다면 ExEmMetricAddr, ExEmMetricLocation , config for httpd 블록의 주석을 해제하고 아래 예시를 참고하여 설정합니다.
  • ExEmMetricAddr에는 webserver agent에서 metric 수집에 필요한 연결 주소를 입력합니다.
  • ExEmMetricLocation 에는 webserver agent에서 metric 수집에 필요한 연결 uri를 입력합니다.
[ 예시 ]
# metrics configuration (default: 127.0.0.1:12849/exem/v1/metrics)
ExEmMetricAddr 10.20.30.40:12849
ExEmMetricLocation /exem/v1/metrics

# config for httpd
Listen 12849
<VirtualHost *:12849>
<Location /exem/v1/metrics>
  SetHandler exem-metrics
</Location>
</VirtualHost>
  • 위의 설정을 통해 exem-webserver-agent가 httpd에 request하는 엔드포인트이기 때문에 사용 시 webserver의 listen 포트(ex:12849)의 방화벽을 확인해야합니다.