XML ファイル・パラメーター、コマンド行オプション、および環境変数の優先順位
ユーティリティーは複数の方法で制御することができます。ユーティリティーに実際にどの方法が適用されるかは、優先順位によって決まります。
「エージェント更新およびデプロイメント」ユーティリティーでは、動作を制御する方法が以下の優先順位で用意されています。
- <Target> エレメント内のパラメーター
- コマンド行オプション
- <Globals> エレメント内のパラメーター
- 環境変数
ユーティリティーは、それぞれの方法を順次検討します。方法が有効な値で定義されている場合、ユーティリティーはその値を使用して、後続の方法をすべて無視します。
例
以下の例では、ユーティリティーがインストーラーを見つける方法について説明します。<Target> と <Globals> の両方のエレメントには、SourceDirectory パラメーターが定義されています。これらのパラメーターは、インストーラーが存在する可能性のある場所を示しています。ただし、ユーティリティーが検査するのは、そのうちのいくつかの場所です。ユーティリティーはインストーラーを見つけるとすぐにそのインストーラーを使用します。
- ユーティリティーは、最初に <Target> エレメント内のパラメーターを検査します。 ..¥test¥wind ディレクトリーが存在する場合、ユーティリティーはそのディレクトリー内のインストーラーを検査します。インストーラーがそのディレクトリーにある場合、ユーティリティーはそのインストーラーを使用します。
- ディレクトリーが存在しないか、存在はするがインストーラーがない場合、ユーティリティーは -sourceDir コマンド行オプションが指定されているかどうかを検査します。有効なディレクトリーでオプションが指定されている場合、ユーティリティーはそのディレクトリーを検査して、そのディレクトリーにあるインストーラーを使用します。
- -sourceDir が指定されなかったか、ディレクトリーが有効ではなかったか、あるいはディレクトリーにインストーラーがなかった場合、ユーティリティーは <Globals> エレメント内のパラメーターを検査します。この時点で、ユーティリティーは ..¥test ディレクトリーを検査します。
- ..¥test ディレクトリーでインストーラーが作成されていない場合、ユーティリティーは SOURCEDIR 環境変数を検査します。 そのディレクトリーが存在しないか、存在はするがインストーラーがない場合、ユーティリティーはエラーを生成します。
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Globals>
<Parameter Name="SourceDirectory" Value="..¥test"/>
<Parameter Name="KeyFile" Value="..¥test¥keyfile.txt"/>
</Globals>
<Target id="9.164.102.169">
<Parameter Name="SourceDirectory" Value="..¥test¥wind"/>
<Parameter Name="ConnectionType" Value="ssh"/>
<Parameter Name="UserName" Value="root"/>
<Parameter Name="Password" Value="toor123"/>
<Parameter Name="ExistingAgentPath" Value="/usr/local/bin/bfagent"/>
<Parameter Name="AgentInstallLocation" Value="/usr/local/bin/bfagent"/>
</Target>
</AgentDeploymentAndUpdate>