대화형 newrelic-install 스크립트는 New Relic에서 PHP 애플리케이션 설치를 단순화합니다. 여러 PHP 설치는 물론 비표준 위치의 설치에서도 작동합니다. 실행하면:
- 올바른 PHP 모듈을 제자리에 복사하십시오.
- 샘플
ini 파일을 설치합니다. - New Relic 프록시 데몬을 구성합니다.
설치 프로그램 스크립트 찾기
설치 프로그램 스크립트 위치는 New Relic PHP 에이전트를 설치한 방법에 따라 다릅니다.
- 시스템 패키지 관리자를 통해: 설치 스크립트는
/usr/bin 디렉토리에 있습니다. - tarball을 통해: 설치 스크립트는
tar 아카이브 파일을 추출한 디렉토리에 있습니다. tar 배포의 스크립트에는 패키지 관리자가 처리하지 않는 설치 단계가 포함되어 있습니다.
여러 PHP 설치 작업
newrelic-install 이(가) 여러 설치를 올바르게 감지하려면 PATH 환경 변수가 올바르게 설정되었는지 확인하십시오. newrelic-install 스크립트는 찾을 수 있는 버전의 에이전트만 설치할 수 있습니다.
원하는 경우... | 이게 ... |
|---|
추가 디렉토리 지정 | 콜론으로 구분된 목록과 함께 NR_INSTALL_PATH 환경 변수를 사용합니다. |
NR_INSTALL_PATH 재정의 및 PATH
| NR_INSTALL_PHPLIST 환경 변수의 디렉토리 세트를 콜론으로 구분된 목록으로 지정하십시오. 이러한 디렉토리에는 PHP의 명령줄 버전 또는 php-config 스크립트가 포함되어야 합니다.
|
설치 프로그램 스크립트 호출
스크립트에는 설치 및 제거 의 두 가지 모드가 있습니다. 인수 없이 호출하면 모드를 선택하라는 메시지가 표시됩니다.
명령줄에서 해당 위치에서 스크립트를 실행합니다.
- 시스템 패키지 관리자를 통해:
/usr/bin/newrelic-install tar 아카이브 디렉토리를 통해: ./newrelic-install
설치 모드 사용
New Relic을 설치하려면 이 절차를 따르십시오.
다음 방법 중 하나 를 사용하여 설치 모드를 호출합니다.
install 명령줄 옵션으로 newrelic-install 을 실행합니다.- 옵션 없이
newrelic-install 을 실행하고 스크립트를 호출할 때 기본 메뉴에서 설치 옵션을 선택합니다.
프롬프트에서 New Relic을 입력하십시오. . 이 키는 나머지 설치 프로세스 중에 생성된 모든 INI 파일에 삽입됩니다.
newrelic-install 이(가) 둘 이상의 PHP 버전을 찾으면 사용할 PHP 버전을 선택합니다. 스크립트가 PHP의 단일 버전만 찾으면 이 화면이 표시되지 않습니다.
예: 메뉴에는 7가지 옵션이 표시됩니다.
2) /usr/local/php/5.2.16/bin
3) /usr/local/php/5.2.16-zts/bin
4) /usr/local/php/5.3.4/bin
5) /usr/local/php/5.3.4-zts/bin
6) /usr/local/php/5.4.19-zts/bin
7) /usr/local/php/5.5.4-zts/bin
Select (1-7, 0 to exit, or all):
ZTS 옵션은 PHP 에이전트 버전 9.17 이하 에만 적용됩니다. ZTS는 PHP 버전 9.18 이상에서 사용할 수 없습니다.
메뉴에서 다음 옵션 중 하나를 사용합니다.
- 하나의 버전만 선택하려면 사용하려는 버전을 나타내는 번호를 입력합니다.
- 여러 버전을 선택하려면 쉼표 또는 공백으로 구분된 숫자 목록을 입력하십시오.
- 나열된 모든 버전을 선택하려면 키워드
all 를 입력하십시오. - 설치 프로세스를 종료하려면
0 을 입력합니다.
선택한 각 디렉터리에 대해 스크립트는 적절한 위치에 에이전트를 설치하려고 시도하고 각 시도에 대해 보고합니다.
중요
여러 .ini 파일을 허용하는 PHP 설치의 경우 수정된 파일이 아직 설치되지 않은 경우 설치 스크립트는 템플릿 파일을 복사합니다. 수동으로 수정해야 하는 .ini 파일을 기록해 둡니다.
PHP 에이전트 버전 4.0 부터 더 이상 사용되지 않는(2013년) PHP 5.1의 단일 버전을 감지하면 설치 프로그램이 제대로 작동하지 않습니다. PHP 5.1을 실행해야 하는 경우 PHP 에이전트 버전 3.9.5.13 을 사용하십시오. 도움이 필요하면 support.newrelic.com 에서 지원을 받으십시오.
패키지 관리자가 데몬을 설치하지 않은 경우 데몬을 설치합니다.
업데이트 또는 재설치인 경우 스크립트는 데몬의 이전 복사본을 덮어쓰기 전에 확인 프롬프트를 제공합니다.
설치에 성공하면 스크립트에 다음과 같은 최종 메시지가 표시됩니다.
New Relic is now installed on your system. Congratulations!
PHP 에이전트를 활성화하려면 웹 서버를 다시 시작하세요.
PHP-FPM을 실행 중인 경우 에이전트가 활성화되기 전에 PHP-FPM을 별도로 다시 시작해야 할 수도 있습니다.
설치 아카이브 파일의 이름과 위치를 기록해 두십시오. 이 파일은 /tmp/nrinstall-nnnn.tar 에 있으며 설치 로그와 New Relic 기술 지원의 문제 해결에 도움이 되는 유용한 시스템 정보를 모두 포함합니다.
New Relic을 성공적으로 설치하고 웹 서버를 다시 시작한 후 애플리케이션에 대한 데이터 수집을 시작할 수 있습니다. 몇 분 후 APM 요약 페이지 에 데이터가 표시되기 시작합니다.
PHP 에이전트와 데몬의 작동을 미세 조정하려면 PHP 구성 옵션 을 검토하십시오.
install_daemon 모드 사용
에이전트 없이 데몬을 설치하려면 PHP 에이전트 9.2 이상을 사용하세요. install_daemon 명령줄 옵션으로 newrelic-install 을 실행합니다.
이것은 데몬이 PHP 애플리케이션과 다른 호스트 또는 다른 컨테이너에서 실행되는 경우에 유용합니다. 예를 들어, 이는 컨테이너에 에이전트를 설치할 때 발생할 수 있습니다.
PHP 설치 문제 해결
설치 프로세스에 문제가 있는 경우 New Relic에 지원을 문의하기 전에 데이터 없음 및 기타 문제 해결 문서를 검토하십시오. 웹 서버에서 생성된 phpinfo() 함수의 출력뿐만 아니라 모든 버그 보고서에 아카이브 파일 을 첨부해야 합니다.
제거 모드
New Relic을 제거하지만 중요한 구성 파일(업그레이드 시 유용)을 유지하거나 시스템에서 New Relic을 영구적으로 제거할 수 있습니다.
이 방법은 제거 및 업그레이드하려는 경우에 유용합니다. 제거는 데몬 구성 파일과 같은 중요한 구성 파일을 제거하지 않습니다. 또한 수정한 newrelic.ini 파일은 제거하지 않습니다.
설치 스크립트를 사용하여 New Relic을 제거하려면 다음 옵션 중 하나를 사용하십시오.
uninstall 옵션으로 newrelic-install 을(를) 호출합니다.- 옵션 없이
newrelic-install 을 실행하고 스크립트를 호출할 때 기본 메뉴에서 제거 옵션을 선택합니다.
시스템에서 New Relic을 영구적으로 제거하려면: purge 옵션으로 newrelic-install 를 호출합니다.
이렇게 하면 설치 시 생성된 모든 구성 파일과 링크가 제거됩니다. 이는 php.in 과 같은 파일에 있는 구성 매개변수에는 영향을 미치지 않습니다 . 또한 시스템에 설치된 소프트웨어 패키지는 제거 되지 않습니다 .
패키지 관리자로 설치된 New Relic 소프트웨어 패키지를 제거하려면 RedHat 및 CentOS 제거 또는 Ubuntu 및 Debian 제거 를 참조하십시오.