Helix Universal Proxy を起動すると、デフォルトの設定ファイルである rmproxy.cfg を読み取ります。 Helix Universal Proxy の設定情報を変更すると、Helix Administrator が自動的に設定ファイルを更新します。この付録では、一般的な情報と、設定ファイルの構造について説明します。
以下のセクションでは、設定ファイルについて知っておくと役立つ予備知識を提供します。
Helix Universal Proxy の起動に関するセクションで説明したとおり、起動時に rmproxy.cfg 以外の設定ファイルを指定することができます。 代わりに指定するファイルは、rmproxy.cfg を元に手動で編集したファイルでもかまいません。 代替ファイルの使用方法については、「Helix Universal Proxy の起動」または「UNIX での起動」を参照してください。
設定ファイルは、必ず許可されたユーザーだけが変更できる場所に保存してください。 デフォルトの保存場所は、Helix Universal Proxy のメイン インストール ディレクトリです。
Helix Universal Proxy のインストール ディレクトリには、default.cfg という名前で、設定ファイルのバックアップ コピーがあります。 このファイルは、インストール中に作成された、デフォルトの rmproxy.cfg ファイルのミラー イメージです。一度変更した内容を後で元に戻す必要がある場合、または作業用コピーを誤って削除してしまった場合に、バックアップ コピーが必要になる可能性があります。
設定ファイルを任意のテキスト エディタで開いて Helix Universal Proxy の設定を変更することができます。 また、初期ファイルには含まれていない変数を追加することもできます。 Helix Universal Proxy で使用できる変数の詳細については、「Helix Universal Proxy 設定ファイル リファレンス」を参照してください。
そのほかに、サードパーティーのプラグインが独自のパラメータや変数を必要とする可能性もあります。そのような変数やパラメータを設定ファイルに追加するには、テキスト エディタを使用します。
設定ファイルの既存の設定を変更するのは簡単です。このセクションでは、その方法を説明します。ただし、新しいセクションを追加する場合は、事前にファイル全体の構文を理解する必要があります。設定ファイルは複数のセクションで構成されます。必ずそのように構成しなければならないわけではありませんが、そうすることでわかりやすくなります。設定ファイルの構成の詳細については、「設定ファイルの構文」セクションを参照してください。
 |
ヒント : まず Helix Administrator を使って変更を行い、設定ファイルがどのように変更されたのかを調べてみることを推奨します。 特に、リストがどのように作成、変更されているかを理解することが重要です。 |
Helix Administrator は、使用中の Helix Universal Proxy 設定ファイルの設定内容を表示します。 テキスト エディタで設定ファイルを開く前に、Helix Administrator を終了してください。そうしないと、予想外の変更が発生する可能性があります。
設定ファイルのデフォルト名は rmproxy.cfg ですが、複数のプロキシを使用する場合は、使用しているプロキシを簡単に特定できるように各設定ファイルの名前を変更することもできます。
設定ファイルを手動で編集する場合、必ず正しい構文を使用するようにしてください。これは、Helix Universal Proxy が、スペルが正確であり適切に山形かっこが使用されている設定ファイルを用いることを前提としているためです。Helix Universal Proxy は構文エラーに関連するメッセージを表示しません。解釈できない設定は無視されます。
テキスト エディタを使用して設定ファイルの設定内容を変更した後は必ず Helix Universal Proxy を再起動してください。
設定ファイルは XML (eXtensible Markup Language) に基づくタグでフォーマットされているテキスト ファイルです。 このファイルによって高度な柔軟性が実現されており、サードパーティーがHelix Universal Proxy の機能を拡張できるようになっています。 Helix Universal Proxy のほかにサードパーティーを使用する場合、機能を有効にするには設定ファイルを手動で編集しなければならないことがあります。
設定ファイルは、全体的にタグで構成されています。 このファイルの中で使用されるタグには 4 種類あります。 XML 宣言タグ、オプション コメント タグ、リスト タグ、および変数タグです。
これら 4 種類のタグのうち、Helix Universal Proxy に命令を与えるのは、リスト タグと変数タグの 2 種類だけです。リスト タグは、MIME タイプやマルチキャスト命令など、いくつかのパーツに分かれる命令に使用されます。リスト タグのあとには、1 つ以上のリスト タグか変数タグが続きます。
リスト タグと変数タグにあるすべての値は、二重引用符で囲みます。
 |
詳細情報 : 設定ファイルの内容の詳細については、「Helix Universal Proxy 設定ファイル リファレンス」を参照してください。 |
XML 宣言タグは、使用している XML のバージョンを示します。Helix Universal Proxy では、XML バージョン 1.0 を使用しています。宣言タグは以下のようになっています。
<?XML Version="1.0" ?> |
コメント タグは、設定ファイル内でタグの機能を識別するのに使用されますが、コメントは必須ではありません。XML コメント タグはちょうど HTML のコメント タグに似ています。最初に <!--、最後に --> がきます。これらのタグは便宜上使用できるもので、Helix Universal Proxy では無視されます。
たとえば以下のコメント タグにより、管理者はそのタグの後ろにあるパラメータでパスの設定が参照されていることがわかります。
<!-- P A T H S --> |
|
ヒント :ある機能を無効にするには、その機能のタグをコメント化します。各タグをコメント化するのではなく、機能の最初の開始タグと最後の終了タグだけを編集します。 |
<List Name= |
... |
</List> |
name の部分には、リストのタイトルが入ります。name では、大文字と小文字を正しく使い分けることが重要です。
リスト タグのあとには、ほかのリスト タグや変数タグが続きます。</List> タグは、リストの終わりを表します。元のリストの中に別のリストがある場合、そのリストでも </List> という終了タグを使用する必要があります。リストに別のリストを含んでいる例としては、ProxyAlternates リストが挙げられます。
|
ヒント :リスト項目の字下げは必須ではありませんが、使用すればわかりやすくなります。 |
<Var name="value"/> |
name の部分には変数のタイトルが入り、value の部分には、文字列または数値が入ります。どちらになるかは、変数によって異なります。name と value では、大文字と小文字の区別が重要です。
リスト変数とは違い、変数に終了タグはありません。その代わり、閉じのかぎかっこ (>) の前にフォワード スラッシュ記号 (/) が表示されます。
|
ヒント :Helix Universal Proxy を再起動しても、変数への変更が反映されていない場合、変数に終わりを示すフォワード スラッシュ記号があるか、変数とフォワード スラッシュ記号の間にスペースがないかを確認します。 |
変数は独立した要素 (LogPath など) となる場合と、リスト タグの中に表示される場合があります。変数がリスト タグ内に表示される場合、その意味はリスト名の値によって変わりますが、構文はリスト内にある変数と明らかに同じです。似たような働きをするリスト タグ内に複数の変数がある場合、それぞれ固有の名前である必要があります。たとえば、各 MIMETypes リスト内の Extension 変数は別々の名前を持つ必要があります。固有の名前にするには、Extension_01、Extension_02 というように、各変数の最後に数字をつけます。
|
© 2002 RealNetworks, Inc. All rights reserved. 詳細については、RealNetworks を参照してください。 画面左側に目次フレームが表示されない場合は、ここをクリックしてください。 |