インタラクティブなnewrelic-installスクリプトにより、New Relic への PHP アプリケーションのインストールが簡素化されます。複数の PHP インストールだけでなく、標準以外の場所へのインストールでも機能します。実行すると:
- 正しいPHPモジュールを所定の位置にコピーします。
- サンプル
iniファイルをインストールします。 - New Relic のプロキシ・デーモンを設定する。
インストーラのスクリプトを探す
インストーラのスクリプトの場所は、New Relic PHP エージェントをどのようにインストールしたかによって異なります。
- システム パッケージ マネージャー経由: インストール スクリプトは
/usr/binディレクトリにあります。 - tarball 経由: インストール スクリプトは、
tarアーカイブ ファイルを抽出したディレクトリにあります。tarディストリビューションのスクリプトには、パッケージ マネージャーによって処理されるインストール手順が含まれています。
複数のPHPをインストールして作業する
newrelic-installが複数のインストールを正しく検出するには、 PATH環境変数が正しく設定されていることを確認してください。newrelic-installスクリプトは、検出できるバージョンのエージェントのみをインストールできます。
If you want to... | Do this... |
|---|
追加ディレクトリの指定 | コロン区切りのリストでNR_INSTALL_PATH環境変数を使用します。 |
NR_INSTALL_PATHを上書きし、 PATH
| NR_INSTALL_PHPLIST環境変数で一連のディレクトリをコロン区切りのリストとして指定します。これらのディレクトリには、コマンド ライン バージョンの PHP またはphp-configスクリプトが含まれている必要があります。
|
インストーラスクリプトの起動
このスクリプトには、 install と uninstall という2つのモードがあります。引数なしで起動した場合、モードの選択を求められます。
コマンドラインから、次の場所でスクリプトを実行します。
- システム パッケージ マネージャー経由:
/usr/bin/newrelic-install tarアーカイブ ディレクトリ経由: ./newrelic-install
インストールモードを使う
以下の手順でNew Relicをインストールします。
次のメソッドのoneを使用してインストール モードを呼び出します。
installコマンド ライン オプションを指定してnewrelic-installを実行します。- オプションなしで
newrelic-installを実行し、スクリプトの呼び出し時にメイン メニューからインストール オプションを選択します。
プロンプトで、New Relic を入力します。 このキーは、インストール プロセスの残りの過程で作成されるすべての INI ファイルに挿入されます。
newrelic-installで複数のバージョンの PHP が見つかった場合は、使用する PHP のバージョンを選択してください。スクリプトが 1 つのバージョンの PHP のみを検出した場合、この画面は表示されません。
Example: メニューには 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 以降では利用できません。
メニューでは、以下のいずれかを選択してください。
- 1つのバージョンのみを選択する場合は、使用したいバージョンを示す番号を入力してください。
- 複数のバージョンを選択するには、カンマまたはスペースで区切った数字を入力してください。
- リストされているすべてのバージョンを選択するには、キーワード
allを入力します。 - インストール プロセスを終了するには、
0と入力します。
選択された各ディレクトリについて、スクリプトはエージェントの適切な場所へのインストールを試み、各試みについて報告します。
重要
複数の.iniファイルを許可する PHP インストールの場合、変更されたファイルがまだインストールされていない場合、インストール スクリプトはテンプレート ファイルを所定の場所にコピーします。手動で変更する必要がある.iniファイルをメモしておいてください。
PHPエージェントバージョン4.0 の時点で、非推奨（2013年）のPHP 5.1の単一バージョンを検出した場合、インストーラーは正常に動作しません。どうしてもPHP 5.1を動作させたい場合は、 PHP agent version 3.9.5.13 を使用してください。ヘルプが必要な場合は、 support.newrelic.com でサポートを受けてください。
デーモンがパッケージマネージャーによってインストールされていない場合は、デーモンをインストールします。
アップデートや再インストールの場合は、デーモンの古いコピーを上書きする前に、スクリプトが確認のプロンプトを表示します。
インストールが成功すると、スクリプトには最後のメッセージが表示されます。
New Relic is now installed on your system. Congratulations!
PHPエージェントを有効にするには、Webサーバーを再起動します。
PHP-FPMを使用している場合は、エージェントが有効になる前にPHP-FPMを別途再起動する必要があるかもしれません。
インストール アーカイブ ファイルの名前と場所をメモします。このファイルは/tmp/nrinstall-nnnn.tarにあり、インストール ログと、New Relic テクニカル サポートのトラブルシューティングに役立つ有用なシステム情報の両方が含まれています。
New Relic を正常にインストールし、Web サーバーを再起動すると、アプリケーションに関するデータの収集を開始できます。 数分後、 APM Summaryページにデータが表示され始めます。
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ソフトウェアパッケージを削除するには、 Uninstalling RedHat and CentOS または Uninstalling Ubuntu and Debian を参照してください。