15 Satelliteプロパティ

次のトピックでは、wcs_properties.jsonファイルのSatelliteカテゴリに関連する各プロパティについて説明します。

Satelliteカテゴリのプロパティについて

WebCenter Siteswcs_properties.jsonファイルのSatelliteに分類されるプロパティは、ローカルまたはリモート・サーバーのどちらで実行しているかにかかわらず、任意のSatelliteサーブレット(Satellite Server)との通信方法を規定します。

また、Satellite Serverは、WebCenter Sitesアプリケーションをホストするサーバーにデフォルトでインストールされるため、各WebCenter Sitesシステムには、ローカルSatelliteサーブレットを構成するSatellite Serverのwcs_properties.jsonファイルがあります。(Satellite Serverがリモート・サーバーでも実行する場合、そのサーバーにはSatellite Serverのwcs_properties.jsonファイルもあることに注意してください。)このファイルのプロパティの詳細は、「Satellite Server JSONファイル」を参照してください。

Satelliteカテゴリのプロパティ

表15-1では、JSONファイルのSatelliteカテゴリに関連する各プロパティについて説明します。

表15-1 Satelliteプロパティ

プロパティ 説明

bservice

この値は、Blob Serverサーブレットのサーブレット・パスです。これは、satellite.blobタグを解決するために移動する場所をSatellite Serverに伝える場合に使用されます。

標準的な値には、iPlanet用の/NASApp/cs/BlobServerおよびサーブレット・ランナー用の/servlet/BlobServerが含まれます。

デフォルト値: /<wcsites.app.contextroot>/BlobServer

cache_folder

レガシー・ページ・キャッシュにのみ適用されます。このプロパティは、ディスク・ベースのキャッシュ・データの場所を指定します。このプロパティが空白のままの場合、キャッシュされたデータは、コンテキストのtempフォルダに格納されます。

デフォルト値: 空白

cache_max

レガシー・ページ・キャッシュにのみ適用されます。このプロパティは、キャッシュに維持するオブジェクトの最大数を指定します。指定したサイズを超えると、オブジェクトはキャッシュから削除されます。LRUメソッドは、キャッシュ・サイズ制限の管理に使用されます。

デフォルト値: 1000000

contentserver.installation.folder

Satellite ServerおよびWebCenter Sitesが同じWebアプリケーションで実行されており、そのためユーザーのセッションを共有する必要があるインストールに適用されます。このプロパティは、Satellite ServerがWebCenter Sitesリソースにアクセスできるように、WebCenter Sitesインストールへのパスを指定します。

可能な値:

  • Satellite ServerがWebCenter Sites以外のWebアプリケーションで実行されている場合は、空白。

  • Satellite ServerがWebCenter Sitesと同じWebアプリケーションで実行されている場合は、<cs_installation_dir>

デフォルト値: <wcsites.home>

cookieprefix

Satellite Serverは、クライアントのかわりにそれ自体とリモート・ホスト間のセッションを管理します。Satellite Serverは、アプリケーション・サーバーが使用するセッションID Cookieを適切に追跡できるように、その名前を把握する必要があります。

ここで、可能なセッションCookie名の接頭辞をセミコロン区切りで入力します。空白のままの場合、デフォルト・セットが使用されます。

デフォルト値: JSESSIONID;WebLogicSession;GX_SESSIONID

cs.satellitehosts

このサーバー(WebCenter Sitesをホストしているサーバー)のCacheManagerが通信する必要があるSatelliteサーブレットをホストするサーバーのホスト名を指定します。

ホスト名のカンマ区切りリストを入力します。各ホストの値は、WebCenter Sitesサーブレットへのパスを含む必要があります。次の形式を使用します。

http://<hostname:port>/<servlet>/

必要に応じて、httpsまたは特殊なポートを使用できます。構成で必要な場合は、必ず完全修飾ドメイン名を指定してください。

このサーバーに常駐するSatelliteサーブレットがデフォルトでリストされます。

cs.satellitepassword

cs.satelliteusersプロパティで指定されるユーザー・アカウントのパスワードを指定します。このサーバーのSatelliteサーブレットのパスワードがデフォルトでリストされることに注意してください。

このプロパティの値は、単一文字列として暗号化されます。そのため、このプロパティの値を編集する場合、カンマ・デリミタを含む、すべてのSatelliteサーブレット・ホストのパスワードをすべて入力する必要があります。

対応するユーザーをcs.satelliteusersプロパティに入力する順序に一致する順序でパスワードのカンマ区切りリストを入力します。必ず、このリストの順序もcs.satellitehostsプロパティに指定されるホスト名のリストの順序に一致するようにしてください。

cs.satelliteusers

Satellite Serverホストのユーザー名を指定します。このサーバーのSatelliteサーブレットのユーザー名がデフォルトでリストされることに注意してください。

cs.satellitepasswordプロパティに指定したパスワードのリストに一致する順序でユーザー名のカンマ区切りリストを入力します。

expiration

inCacheページ・キャッシュおよびレガシー・ページ・キャッシュに適用されます。このプロパティは、指定の該当情報がどこにもないキャッシュ済オブジェクトすべてに対して、期限切れ情報を(COM.FutureTense.Util.TimePattern文字列の形式で)指定します。

オブジェクトの期限切れ情報は、satellite.page (および関連)タグのcachecontrol属性で指定できます。ページの場合、期限切れ情報は、SiteCatalogのsscacheinfo列でも指定できます。バイナリ・オブジェクトの場合、cachecontrol属性のデフォルト値は、futuretense.iniファイルで指定されます。

リクエストの最外部のラッパー・ページではオーバーライドを指定できないため、このプロパティが、オーバーライドを制御できる唯一の場所になる点に注意してください。

デフォルト値: 5:0:0 */*/*

つまり、Satellite Serverキャッシュの内容はすべて毎日午前5:00に期限が切れます。

書式は次のとおりです。

<hours>:<minutes>:<seconds> <daysOfWeek>/<daysOfMonth>/<months>

可能な値:

  • <hours>: 0から23、0は午前零時

  • <minutes>:0から59

  • <seconds>:0から59

  • <daysOfWeek>: 0から6、0は日曜日

  • <daysOfMonth>: 1から31

  • <months>: 1から12

その他の可能な値:

  • never。キャッシュがいっぱいで、そのページが最も長い間使用されていない場合のみ、ページの有効期限が切れます。

  • immediate。ページのキャッシュは行いません。

file_size

レガシー・ページ・キャッシュに適用されます。このプロパティは、ディスクにキャッシュ可能なオブジェクトのサイズ(KB単位)を指定します。比較的小さなオブジェクトがメモリーに保持されます。

この値は、システムRAM、ディスク速度などに対して調整する必要があります。

デフォルト値: 250

formaction

Satelliteサーブレットは、GETまたはPOSTを実行するWebCenter SitesのURLをSatelliteのURLに変換します。このプロパティは、SatelliteのURLを作成するためにWebCenter SitesのURLのどの文字列を置換するかを指定します。

この値では大/小文字が区別されます。

Satellite Server 6で有効です。すべてのフォームに新しいsatellite.formタグを使用します。

デフォルト値: action=\"ContentServer\"

globally_replace_contentserver

このプロパティをtrueに設定すると、Satellite ServerはWebCenter Sitesから返されるすべての処理可能なページを解析し、formactionプロパティに記述された文字列のすべてのインスタンスを、newformactionプロパティに記述された文字列に置換します。また、ContentServerを、servletプロパティで記述される文字列に置き換えます。

デフォルト値: false

host

Satelliteエンジンがリクエストをキャッシュする、WebCenter Sitesを実行するリモート・ホスト・システムの名前。

これは必須ですが、デフォルトはありません。

newformaction

GETまたはPOSTが実行されるURLの置換え文字列を、ローカルにマップされたサーブレットに指定します。

この値では大/小文字が区別されます。

Satellite Server 6で有効です。すべてのフォームに新しいsatellite.formタグを使用します。

デフォルト値: action=\"Satellite\"

port

WebCenter Sitesホストと通信するためのポート番号。

デフォルト値: 80

protocol

Satellite ServerホストとWebCenter Sitesホスト間の通信プロトコル。(通常はhttp://またはhttps://)。

プロトコルをhttps://に設定すると、それ自体でセキュアな通信は保証されないことに注意してください。引き続き、証明書の取得が必要です。

デフォルト値: <wcsites.app.protocal>://

service

この値は、WebCenter Sitesサーブレットのサーブレット・パスです。

これは、satellite.pageタグを解決するために移動する場所をSatellite Serverに伝える場合に使用されます。

標準的な値には、iPlanet用の/NASApp/cs/ContentServerおよびサーブレット・ランナー用の/servlet/ContentServerが含まれます。

デフォルト値: /<wcsites.app.contextroot>/ContentServer

servlet

Satellite Serverサーブレットの識別に使用されるURLパターンを指定します。Satellite Serverは、ページが適切に設計される場合、このURLパターンを使用するようにリンクとフォームをリライトします。

デフォルト値: Satellite

sessionid.cookie.prefix

ユーザーは、ここでセッションID Cookieの先頭に付加される接頭辞を指定できます。

セッションID Cookieはホスト(つまり、WebCenter Sites)のセッションID Cookieです。Satellite Serverは、WebCenter Sitesとクライアント間のセッションを維持するために、セッションID Cookieをクライアントに渡す必要があります。

Cookieの名前は変更する必要があるため、Satellite Server自体が使用するセッションCookieと競合することはありません。構成可能な接頭辞を使用すると、セッションID Cookieの名前を把握するユーザーは、完全なCookie名を構築できます。これは、サーブレット・フィルタや他のメカニズムで使用してカスタム機能をサポートできます。

デフォルト値: SS_X_

sharesession

ContentServerサーブレットとSatelliteサーブレットでユーザー・セッションを共有するかどうかを指定します。

Satellite Serverをリモートで実行する場合、これをfalseに設定し、Satellite ServerとContentServerが共在する場合は、このプロパティをtrueに設定します。

このプロパティを適切に設定しないと、ユーザーに固有の情報がページ間で矛盾することがあります。

デフォルト値: true

ss.password

Satellite Server側のSatellite Serverユーザーのパスワード。これは、双方向ハッシュ機能を使用して暗号化されます。

デフォルト値: <wcsites.satelliteserver.password>

ss.username

Satellite Server側のSatellite Serverユーザーのユーザー名。これはwcsites.satelliteserver.usernameプロパティの値と一致する必要があります。

デフォルト値: <wcsites.satelliteserver.username>

transparent.content-type.pattern

ページレット、他のWebCenter Sitesページへのリンク、BLOBへのリンクなど、ネストされたコンポーネントを含むコンテンツ・タイプを示す正規表現。

デフォルト値: text/.*|.*xml.*

wcsites.satelliteserver.password

WebCenter SitesシステムのSatellite Serverユーザーのパスワード。これは、双方向ハッシュ機能を使用して暗号化されます。

デフォルト値: <wcsites.satelliteserver.password>

wcsites.satelliteserver.username

WebCenter SitesシステムのSatellite Serverユーザー名を指定します。

デフォルト値: satteliteserver