Puppet や Chef などのシステムを介して New Relic をインストールするには、 newrelic-install
スクリプトをサイレントモードで実行し、いくつかの環境変数を介して制御できます。このドキュメントでは、環境変数を手動で設定して、 PHP インストール スクリプトをサイレント モードで実行できるようにするための情報を提供します。
インストーラの選択
PuppetやChefなどのシステムを使ってNew Relicを展開する場合、2つの選択肢があります。
- Puppetを使って、ネイティブのパッケージマネージャ(rpm または dpkg)を使ってアーカイブをインストールします。
- tarball distributionの内容を配布し、選択した場所にファイルを配置する。
パッケージ システム経由でインストールする場合、パッケージ インストール スクリプトによってファイルが配置されます。Ubuntu ベースのシステムは例外です。標準の PHP がインストールされている場合、インストール後のスクリプトによって New Relic 拡張機能のシンボリック リンクが作成されます。ただし、これは Puppet または Chef スクリプトに任されているため、 newrelic-install
の実行は試行されません。
Puppet や Chef などのシステムを介して New Relic をインストールするには、 newrelic-install
スクリプトをサイレントモードで実行し、いくつかの環境変数を介して制御できます。
環境変数の設定
これは、動作を制御するためにnewrelic-install
を呼び出す前に設定できる環境変数のリストです。これらの環境変数を使用するだけでなく、インストール時にnewrelic.ini
ファイルでライセンス キーとアプリケーション名も定義してください。
重要
NR_INSTALL_SILENT
インストールをサイレント モードで実行するかどうかを決定します。設定されている場合、スクリプトのすべての情報は、これらの環境変数を介して提供する必要があります。
タイプ: | 旗 |
---|
デフォルト: | (無し) |
---|
使う。 | 任意の値を設定すると、フラグがtrueになります。 |
---|
設定すると、 スクリプト がサイレントモードで実行されます。これにより、ほとんどのステータスメッセージが表示されなくなり、ユーザーの入力に対しても停止しなくなります。
サイレントモードで実行する場合、スクリプトに必要なすべての情報は、これらの環境変数を介して提供されなければなりません。
設定した場合、 install
またはuninstall
コマンド ライン オプションを使用してスクリプトを呼び出し、実行モードを設定する必要があります。
タイプ: | 旗 |
---|
デフォルト: | (無し) |
---|
使う。 | 任意の値を設定すると、フラグがtrueになります。 |
---|
セットされていると、スクリプトは Bourne Again Shell (bash) や Korn Shell (ksh) での再実行を試みません。
このスクリプトは、従来の Bourne シェルの実装にはない機能を使用しており、デフォルトでは、それらの機能を実装していることがわかっているシェルで再実行しようとします。
/bin/sh
が ksh または bash のいずれかであることがわかっている場合は、この変数を任意の値に設定することで、この再実行を防ぐことができます。
タイプ: | パス |
---|
デフォルト: | (無し) |
---|
使う。 | スクリプトに互換性のあるシェルを指定します。 |
---|
インストールスクリプトは、いくつかの非常に古い Bourne シェルの実装には存在しない特定の機能に依存しています。そのようなシステムに導入する場合は、この変数に、スクリプトが再実行するための代替シェルを指定してください。
NR_INSTALL_NOKSH
が設定されている場合、この変数は無視されます。
お使いのバージョンの/bin/sh
が本当に Zsh の 3.x より前のバージョンのリンクである場合は、これを Bash などのより Korn と互換性のあるシェルに設定する必要がある場合があります。
タイプ: | コロンで区切られたディレクトリのリスト |
---|
デフォルト: | (無し) |
---|
使う。 | $PATH に追加するディレクトリを一覧表示します。
|
---|
PHP インストールを検索する現在の$PATH
に追加する、コロンで区切られたディレクトリのリストが含まれます。
Puppet または Chef からスクリプトを呼び出した時点で$PATH
以外の非標準の場所に PHP がインストールされている場合は、この変数を設定できます。PATH
を直接編集して、これらのディレクトリを含めることもできます。
タイプ: | コロンで区切られたディレクトリのリスト |
---|
デフォルト: | (無し) |
---|
使う。 | New Relic をインストールするディレクトリの一覧です。 |
---|
New Relic をインストールするディレクトリをコロンで区切って指定します。
設定されている場合、排他リストが含まれ、 PATH
またはNR_INSTALL_PATH
で指定されたディレクトリにあるバージョンは無視されます。
タイプ: | ストリング |
---|
デフォルト: | (無し) |
---|
使う。 | スクリプトベースの検出を無効にするには、 x86 または x64 のいずれかに設定します。 |
---|
これは、アーキテクチャを自動的に決定しようとする試みを無効にします。
64 ビットシステム上で動作している場合、この設定を x86 にすると、スクリプトに 32 ビットのデーモン(tar ボールからインストールしている場合)とエージェントが強制的にインストールされます。
x64 に設定すると、64ビットのデーモンがインストールされ、PHPのバージョンが64ビットか32ビットかをスクリプトが検出できるようになります。
これを設定する必要はありません。これは念のために用意されています。
タイプ: | ストリング |
---|
デフォルト: | (無し) |
---|
使う。 | New Relic に設定する 新しいインストールで。 |
---|
新規インストールで、新しい newrelic.ini ファイルを作成する必要がある場合は、この値にライセンスキーを設定します。
タイプ: | ストリング |
---|
デフォルト: | (無し) |
---|
使う。 | 対象となる起動デーモンの名前を指定します。 |
---|
デーモンのスタートアップスクリプトの名前が書かれています。
デフォルトの名前を使用したくない場合に使用します。
タイプ: | パス |
---|
デフォルト: | (無し) |
---|
使う。 | New Relic プロキシ・デーモンのフル・インストール・パスを指定する。 |
---|
New Relic プロキシデーモンのインストールパスのフルパスを含みます。
Solaris を除くすべてのシステムで、デフォルトは/usr/bin/newrelic-daemon
です。Solaris の場合、デフォルトは/opt/newrelic/bin/newrelic-daemon
です。
これを変更する場合は、 init スクリプトやその設定ファイルを編集する必要があるかもしれません。
タイプ: | 旗 |
---|
デフォルト: | (無し) |
---|
使う。 | 任意の値を設定すると、フラグがtrueになります。 |
---|
インストールスクリプトに、シンボリックリンクを使わずにエージェントを所定の場所にコピーするように指示します。これは、PHP プロセスがアクセスできないような場所 (例えば、ルートユーザーのホームディレクトリなど) にエージェントを展開した場合に便利です。