インタラクティブな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
スクリプトが含まれている必要があります。
インストーラスクリプトの起動 このスクリプトには、 install と uninstall という2つのモードがあります。引数なしで起動した場合、モードの選択を求められます。
コマンドラインから、次の場所でスクリプト を実行します。
システム パッケージ マネージャー経由: /usr/bin/newrelic-install
tar
アーカイブ ディレクトリ経由: ./newrelic-install
インストールモードを使う 以下の手順でNew Relicをインストールします。
1.インストールモードを起動します。 one のいずれかの方法でインストールモードを起動します。
install
コマンド ライン オプションを指定してnewrelic-install
を実行します。オプションなしでnewrelic-install
を実行し、スクリプトの呼び出し時にメイン メニューからインストール オプションを選択します。 2.New Relic のライセンスキーを入力します。 プロンプトで、New Relic を入力します ライセンスキー . このキーは、残りのインストール プロセスで作成されるすべての INI ファイルに挿入されます。
3.必要に応じて、使用するPHPのバージョンを選択します。 newrelic-install
で複数のバージョンの PHP が見つかった場合は、使用する PHP のバージョンを選択してください。スクリプトが 1 つのバージョンの 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 以降では利用できません。
メニューでは、以下のいずれかを選択してください。
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 でサポートを受けてください。
4.必要に応じてデーモンをインストールします。 デーモンがパッケージマネージャーによってインストールされていない場合は、デーモンをインストールします。
アップデートや再インストールの場合は、デーモンの古いコピーを上書きする前に、スクリプトが確認のプロンプトを表示します。
インストールが成功すると、スクリプトには最後のメッセージが表示されます。
New Relic is now installed on your system. Congratulations!
5.Webサーバーを再起動します。 PHPエージェントを有効にするには、Webサーバーを再起動します。
PHP-FPMを使用している場合は、エージェントが有効になる前にPHP-FPMを別途再起動する必要があるかもしれません。
6.アーカイブファイルをメモする。 インストール アーカイブ ファイルの名前と場所をメモします。このファイルは/tmp/nrinstall-nnnn.tar
にあり、インストール ログと、New Relic テクニカル サポートのトラブルシューティングに役立つ有用なシステム情報の両方が含まれています。
7.設定を微調整します。 New Relic を正常にインストールし、ウェブサーバーを再起動すると、アプリケーションに関するデータの収集を開始できます。数分後、データが APM Summary page に表示され始めます。
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を完全にアンインストールします。 システムから New Relic を完全にアンインストールするには: purge
オプションを指定してnewrelic-install
を呼び出します。
これにより、インストール時に作成されたすべての構成ファイルとリンクが削除されます。これは、 php.in
などのファイルに配置された構成パラメーターには影響しません 。また、システムにインストールされているソフトウェア パッケージは削除されません 。
パッケージマネージャーでインストールしたNew Relicソフトウェアパッケージを削除するには、 Uninstalling RedHat and CentOS または Uninstalling Ubuntu and Debian を参照してください。