メインコンテンツまでスキップ

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はパッケージ内部に構成されたファイルを確認する用途で使用

=====================================================
 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)のファイアウォールを確認する必要があります。