설치 문제 해결
PHP 확장 모듈 및 whatap-php 서비스 수동 설정
PHP 확장 모듈과 whatap-php 서비스 설치 및 선택 설치(install.sh)가 정상적으로 이루어지지 않을 경우 수동으로 설정하는 방법을 설명합니다. PHP 컴파일 설치 등의 이유로 환경 정보를 확인할 수 없는 경우 사용하세요.
whatap.ini 생성
$ cp /usr/whatap/php/template.ini /usr/whatap/php/whatap.ini
$ vi /usr/whatap/php/whatap.ini
# 상단에 내용 추가
; Enable whatap extension module
extension=whatap.so
whatap.license= # 발급된 액세스 키
whatap.server.host= # 발급된 서버 IP
whatap.app_name= # 웹서버 구분 APHP, FPHP (apache : APHP, php-fpm : FPHP)
whatap.app_process_name= # apache, php-fpm 의 프로세스 이름(httpd,php-fpm)
설정 | 설명 |
---|---|
whatap.license | 프로젝트 메뉴 > 관리 > 에이전트 설치 페이지에서 발급된 액세스 키를 확인할 수 있습니다. |
whatap.server.host | 프로젝트 메뉴 > 관리 > 에이전트 설치 페이지에서 발급된 서버 IP를 확인할 수 있습니다. |
whatap.app_name | Apache 서버는 APHP , php-fpm 은 FPHP 를 사용합니다. |
whatap.app_process_name | Apache 또는 php-fpm 의 실행 프로세스 이름 설정으로 정확한 프로세스명 입력하면, 해당 프로세스에 대한 사용 메모리를 수집합니다. 예시로 httpd , apache2 , php-fpm 등을 들 수 있습니다. |
PHP 명령어(CLI) 경로 확인
$ which php
/usr/bin/php
whatap-php 서비스 환경 변수 설정
$WHATAP_PHP_BIN
환경 변수에 PHP CLI 명령어의 경로를 설정하세요.
$ sudo vi /etc/init.d/whatap-php
export WHATAP_PHP_BIN= # PHP 명령어 위치(/usr/bin/php)
PHP API 버전 확인
$WHATAP_PHP_BIN
환경 변수에 PHP CLI 명령어의 경로를 설정하세요.
$ sudo php -i | grep 'PHP API'
PHP API => 20100412
PHP ZTS(Zend Thread Safe) 지원 여부 확인
$ sudo apachectl -V | grep MPM
Server MPM: Prefork # ZTS 지원 안함
Server MPM: Worker # ZTS 지원
$ sudo php-fpm -i | grep Thread
Thread Safety => disabled # ZTS 지원 안함
Thread Safety => enabled # ZTS 지원
PHP 확장 모듈 경로 확인 및 설정
PHP 확장 모듈 경로 확인
$ sudo php -i | grep extension_dir
extension_dir => /usr/lib64/php/modules => /usr/lib64/php/modules
PHP 확장 모듈 설정
PHP API 버전, PHP ZTS 지원 여부를 확인하여 환경에 적합한 라이브러리를 선택하세요. PHP 확장 모듈(PHP Extension module) 경로에 whatap.so 파일명을 복사하세요.
-
PHP ZTS를 지원할 경우 - whatap_zts_[PHP API 버전].so
-
PHP ZTS를 지원하지 않을 경우 - whatap_[PHP API 버전].so
# PHP ZTS 지원하지 않을 경우 예시
$ sudo cp /usr/whatap/php/modules/x64/whatap_20100412.so /usr/lib64/php/modules/whatap.so
whatap-php 서비스 환경 변수 설정
$ sudo vi /etc/init.d/whatap-php
export WHATAP_PHP_EXT_HOME= # PHP Extension 경로(/usr/lib64/php/modules)
export WHATAP_PHP_EXT_SRC= # 와탭 라이브러리 경로 및 파일명
# (/usr/whatap/php/modules/x64/whatap_20100412.so)]
$WHATAP_PHP_EXT_HOME
환경변수에 PHP 확장 모듈 경로를 설정하세요.$WHATAP_PHP_EXT_SRC
환경변수에 와탭 라이브러리 전체 파일 경로를 설정하세요.
whatap.ini 설정
-
PHP 추가 ini 설정 경로를 확인하세요.
$ sudo php -i | grep '.ini files'
Scan this dir for additional .ini files => /etc/php.d -
whatap.ini를 해당 경로에 복사하세요.
$ sudo cp /usr/whatap/php/whatap.ini /etc/php.d/whtap/ini
PHP 추가 ini 설정 경로 확인 불가
PHP 컴파일(Compile) 설치 옵션 --with-config-file-scan-dir=PATH
이 설정 안된 경우에 발생합니다.
$ sudo php -i | grep '.ini files'
Scan this dir for additional .ini files => (none)
whatap.ini 파일 내용을 php.ini 마지막에 추가하세요.
$ php -i | grep 'php.ini'
Loaded Configuration File => /etc/php.ini
$ sudo vi php.ini
# 파일 마지막에 추가
[whatap]
;Enable whatap extension module
extension=whatap.so
whatap.ext.error_enabled=true
whatap.ext.exception_enabled=true
whatap.trace_user_enabled=true
whatap.trace_user_using_ip=false
이외 옵션은 /usr/whatap/php/whatap.ini 를 사용하세요.
whatap-php 서비스(Service) 환경 변수 설정
$WHATAP_CONFIG_HOME
환경변수에 whatap.ini 경로를 설정하세요.
PHP 추가 ini 경로를 확인 할 수 없는 경우 whatap.ini를 생성한 /usr/whatap/php 경로를 설정하세요.
$ sudo vi /etc/init.d/whatap-php
export WHATAP_CONFIG_HOME= # whatap.ini 경로(/etc/php.d)
서비스 재시작
- Apache 및 PHP-FPM 서비스를 재시작하세요.
- whatap-php 서비스를 재시작하세요.
Error: Not found PHP API
PHP 명령어(CLI)를 찾지 못하는 경우 발생합니다.
PHP 명령어(CLI)의 위치를 정확히 확인하고 PHP 확장 모듈 및 whatap-php 서비스 선택 설치 항목을 진행하세요.
$ sudo php -i | grep 'PHP API'
PHP API => 20100412
Error: Not found PHP ini directory
PHP 환경 중 Scan this dir for additional .ini files
항목의 값을 확인하지 못 한 경우 발생합니다. PHP 컴파일 설치 옵션 --with-config-file-scan-dir=PATH
이 설정되지 않은 경우 해당 환경정보가 없습니다.
다음 설명서를 참조하여 PHP 명령어(CLI)의 위치를 정확히 확인하고 PHP 확장 모듈 및 whatap-php 서비스 선택 설치 항목을 진행하세요.
$ sudo php -i | grep '.ini files'
Scan this dir for additional .ini files => (none)