12 ポータル カスタム WLST コマンド

ポータル カスタム WLST コマンドは、WLST コマンドの拡張機能であり、Oracle Portal 固有のものです。表 12-1 では、ポータル カスタム WLST コマンドのカテゴリを示します。

ポータルの管理とコンフィグレーションの詳細については、『Oracle Portal のコンフィグレーション ガイド』を参照してください。

注意 : これらのコマンドを使用するには、コンポーネントがインストールされる Oracle ホームから WLST を呼び出す必要があります。『Oracle Fusion Middleware 管理者ガイド』の「カスタム WLST コマンドの使用」を参照してください。

表 12-1 ポータル WLST コマンド カテゴリ

コマンド カテゴリ	説明
データベース アクセス記述子コマンド	一般的な DAD または Portal DAD を作成、編集または削除します。
コンフィグレーション コマンド	コンフィグレーション コマンドは、 WebCache コンフィグレーションおよび Oracle Internet Directory データを表示し、更新します。 ポータル キャッシュ、ポータル ページ エンジン、およびポータル中間層をコンフィグレーションします。 ポータル サイトのコンフィグレーションを示します。

データベース アクセス記述子コマンド

データベース アクセス記述子 (DAD) は、HTTP リクエストを処理するためにアプリケーションが Oracle データベースに接続する方法を指定する値のセットです。DAD の情報には、データベースのユーザ名 (スキーマと特権も指定する)、パスワード、接続文字列、およびグローバライゼーション サポート言語が含まれています。

DAD には、一般的な DAD と Portal DAD の 2 つの種類があります。Oracle Portal 中層は Portal DAD を使用して、Oracle メタデータ リポジトリにアクセスします。一般的な DAD の詳細については、『Oracle Fusion Middleware Oracle HTTP Server 管理者ガイド』を参照してください。

表 12-2 で示したデータベース アクセス記述子コマンドを使用して、WLST コマンドライン スクリプト インタフェースから Portal DAD を作成、編集または削除します。アクションに基づいて portal_dads.conf ファイルが更新されます。

表 12-2 ポータル WLST コンフィグレーションのデータベース アクセス記述子コマンド

コマンド	説明	WLST の使用状況
listDads	コンフィグレーションするためにデータベース アクセス記述子が使用するパラメータの一覧を表示します。	オンライン
createPortalDad	ポータル データベース アクセス記述子を作成します。	オンライン
updatePortalDad	ポータル データベース アクセス記述子の属性を更新します。	オンライン
deletePortalDad	ポータル データベース アクセス記述子を削除します。	オンライン

listDads

コマンド カテゴリ : データベース アクセス記述子コマンド

WLST の使用状況 : オンライン

説明

すべてのデータベース アクセス記述子 (一般的な DAD および Portal DAD の両方) で指定したパラメータの一覧を表示します。

構文

listDads ()

例

以下の例では、ドメイン内のさまざまな DAD を表示します。

listDads()
------------
/pls/portal1
Schema: h1user
Connect String: foo.oracle.com:1521:orcl
NLS Language: "AMERICAN_AMERICA.AL32UTF8"

createPortalDad

コマンド カテゴリ : データベース アクセス記述子コマンド

WLST の使用状況 : オンライン

説明

ポータル データベース アクセス記述子を作成します。

構文

createPortalDad (name, schema, password, [connect_string], nls_language)

引数	定義
name	データベース アクセス記述子の名前。
schema	ポータル データベース アカウントのユーザ名。
password	ポータル データベース アカウントのパスワード。
connect_string	省略可能。リモート データベースに接続するために使用する接続文字列。 接続文字列は、ホスト名 : ポート番号 : 接続文字列で構成される場合があります。接続文字列は、ServiceNameFormat (host:port:database_service_name)、SIDFormat (host:port:database_sid) または TNSFormat (TNS エリアスまたは全体の TNS エントリ) の形式である場合もあります。
nls_language	この DAD で表現されるポータル データベースのグローバライゼーション サポート言語。この設定はデータベース セッションの NLS_LANG 環境変数をオーバーライドし、応答文字セットを含む応答のいくつかの重要なグローバライゼーション サポート プロパティを定義します。 この言語設定がバックエンド データベースの NLS_LANG に一致することを確認します。

例

次の例では、指定された引数に基づいて portal1 Portal DAD を作成します。

createPortalDad(name='portal1',schema='schema',password='welcome1',connect_
string='foo.oracle.com:1521:orcl',nls_language='AMERICAN_AMERICA.AL32UTF8')

updatePortalDad

コマンド カテゴリ : データベース アクセス記述子コマンド

WLST の使用状況 : オンライン

説明

ポータル データベース アクセス記述子の属性を更新します。

構文

updatePortalDad (name, [schema], [password], [connect_string], [nls_language])

引数	定義
name	データベース アクセス記述子の名前。この名前は更新中に変更できません。
schema	省略可能。ポータル データベース アカウントのユーザ名。
password	省略可能。ポータル データベース アカウントのパスワード。
connect_string	省略可能。リモート データベースに接続するために使用する接続文字列。 接続文字列は、ホスト名 : ポート番号 : 接続文字列で構成される場合があります。接続文字列は、ServiceNameFormat (host:port:database_service_name)、SIDFormat (host:port:database_sid) または TNSFormat (TNS エリアスまたは全体の TNS エントリ) の形式である場合もあります。
nls_language	省略可能。この DAD で表現されるポータル データベースのグローバライゼーション サポート言語。この設定は、データベース セッションの NLS_LANG 環境変数をオーバーライドし、応答文字セットを含む応答のいくつかの重要なグローバライゼーション サポート プロパティを定義します。この言語設定がバックエンド データベースの NLS_LANG に一致することを確認します。

例

次の例では、指定された引数に基づいて portal1 Portal DAD を更新します。

updatePortalDad(name='portal1',schema='user1',password='welcome2',connect_
string='foo.oracle.com:1521:orcl',nls_language='AMERICAN_AMERICA.AL32UTF8')

deletePortalDad

コマンド カテゴリ : データベース アクセス記述子コマンド

WLST の使用状況 : オンライン

説明

ポータル データベース アクセス記述子を削除します。

構文

deletePortalDad(name)

引数	定義
name	ポータル データベース アクセス記述子の名前。

例

次の例では、portal_dads.conf ファイルから portal1 Portal DAD エントリを削除します。

deletePortalDad(name='portal1')

コンフィグレーション コマンド

表 12-3 に示すコンフィグレーション コマンドを使用して、ポータル キャッシュ、WebCache、Oracle Internet Directory データなどを表示およびコンフィグレーションします。

表 12-3 ポータル WLST コンフィグレーションのコンフィグレーション コマンド

コマンド	説明	WLST の使用状況
configurePortalCache	ポータル キャッシュの属性を更新します。	オンライン
configurePortalPageEngine	ポータル中間層の属性を更新します。	オンライン
listPortalWebcacheConfigAttributes	WebCache コンフィグレーションの属性を一覧表示します。	オンライン
listPortalSiteConfigAttributes	ポータル サイトのコンフィグレーションの属性を一覧表示します。	オンライン
listPortalOIDConfigAttributes	Oracle Internet Directory コンフィグレーションの属性を一覧表示します。	オンライン
setPortalWebcacheConfig	WebCache コンフィグレーションの属性を更新します。	オンライン
setPortalOIDConfig	Oracle Internet Directory コンフィグレーションの属性を更新します。	オンライン
setPortalMidtierConfig	ポータル中間層コンフィグレーションの属性を更新します。	オンライン

configurePortalCache

コマンド カテゴリ : コンフィグレーション コマンド

WLST の使用状況 : オンライン

説明

ポータル キャッシュは、Oracle Portal ページおよびポートレットに対するファイル システム ベースのキャッシュです。ポータル キャッシュは、検証ベースのキャッシングおよび期限ベースのキャッシングをサポートします。ポータル キャッシュは、ポータルのコンテンツ キャッシュおよびセッション キャッシュの両方で構成されています。

このコマンドは、ポータル キャッシュの属性を更新します。これらのコンフィグレーションの詳細は、<Middleware Home>/user_projects/domains/<DOMAIN_HOME>/servers/WLS_PORTAL/stage/portal/portal/configuration/portal_cache.conf ファイルに格納されます。

構文

configurePortalCache([enable], [directory], [total_size], [max_size], 
[cleanup_time], [max_age])

引数	定義
enable	省略可能。ポータルのコンテンツ キャッシングおよびセッション キャッシングを有効 (On) または無効 (Off) にします。
directory	省略可能。キャッシュされるコンテンツが格納されるディレクトリ。 このディレクトリは存在し、読み込みアクセス権および書き込みアクセス権があることを確認します。
total_size	省略可能。ポータル キャッシュが使用できるディスク スペースの総量 (MB 単位)。指定できる最大値は 4 GB です。
max_size	省略可能。キャッシュされたすべてのファイルの最大サイズ (バイト単位)。最大許容値は 4 GB です。この制限を超える動的に生成されるコンテンツがキャッシュされません。
cleanup_time	省略可能。キャッシュ ストレージのクリーンアップを開始する時刻。クリーンアップを開始する日時を正確に定義するには、[Sunday-Saturday, Everyday, Everymonth][hh:mm] の書式を使用します。
max_age	省略可能。キャッシュされた単一のドキュメントの最大存続期間。この設定にすると、キャッシュ システムが古いコンテンツを含まないようになります。新しいキャッシュ ファイル用にスペースを作り出すために、古いキャッシュ ファイルが削除されます。デフォルト値は 30 日です。

例

次の例では、ポータル キャッシュをコンフィグレーションします。

configurePortalCache(enable=true,directory='/scratch/user/installs/Inst_1
/cache/PortalComponent/portal',total_size=10101010,max_size=12300033,cleanup_
time='Everyday 11:00',max_age=20)

configurePortalPageEngine

コマンド カテゴリ : コンフィグレーション コマンド

WLST の使用状況 : オンライン

説明

Oracle Fusion Middleware Portal アーキテクチャは、3 層アーキテクチャで設計されており、任意のブラウザから接続できます。この柔軟なアーキテクチャにより、必要に応じて各構成要素 (ブラウザ、Oracle HTTP Server リスナ、Oracle Database 11g および Oracle Portal) を個別にアップグレードできます。

Oracle Portal 中間層の一部である PPE (Parallel Page Engine) は、Oracle Containers for J2EE およびサービス ページのリクエスト内で実行されるサーブレットです。PPE によって、ページ メタデータの読み込み、ポートレット コンテンツに対応するプロバイダのコール、プロバイダのレスポンスの受け入れ、および指定されたページ レイアウトに従ったリクエストされたページの作成が行われます。

このコマンドは、ポータル中間層リポジトリ サーブレットで使用されるコンフィグレーション ファイル appConfig.xml のプロパティを更新します。このコンフィグレーション ファイルは、$MWHOME/user_projects/domains/AllClassicDomain/servers/WLS_PORTAL/stage/portal/portal/configuration/ ディレクトリにあります。

構文

configurePortalPageEngine([encrypt_key], [resource_url_key], [use_port], [use_
scheme], [x509certfile])

引数	定義
encrypt_key	省略可能。WebCache でキャッシュするために使用するヘッダーを暗号化する HMCA キーを指定します。これにより、キャッシュ・キーのセキュリティが向上し、不正なリクエストがキャッシュされたオブジェクトを取得する可能性が低くなります。
resource_url_key	省略可能。このキーは、WSRP リソースおよび JPDK リソースのプロキシ処理によってリクエストされた URL に対してチェックサムを計算するために PPE サーブレットで使用されます。WSRP リソースのプロキシ処理を機能させるには、キーの値に 10 文字以上の英数字値を設定する必要があります。また、JPDK のプロキシ処理では、プロバイダに対して JNDI 環境変数 (resourceUrlKey とも呼ばれる) を設定する必要があります。
use_port	省略可能。PPE がポータルにリクエストするときに使用されるポートをオーバーライドします。指定しない場合、デフォルトで、ページ リクエストのポートが使用されます。useScheme を設定する場合、usePort 引数も設定する必要があります。 このオプションは、他の理由のためにも使用できますが、SSL はブラウザおよび PPE の間に実行するが、PPE およびポータルの間に実行しない場合に使用されます。この場合は、ループバック リクエストの非 SSL ポートは、ブラウザで使用される SSL ポートと異なります。
use_scheme	省略可能。PPE がポータルにリクエストを行うときに使用されるスキーマ (HTTP または HTTPS) をオーバーライドします。指定しない場合、デフォルトでページ リクエストのスキーマが使用されます。useScheme を設定する場合、usePort 引数も設定する必要があります。
x509certfile	省略可能。HTTPClient が暗黙的に信頼する証明書のリストを含むファイルを指定します。これらの証明書は、SSL を使用する HTTPClient によって行われたすべての接続に対するトラスト ポイントとして追加されます。

例

次の例では、指定された引数に基づいてポータル ページ エンジンを更新します。

configurePortalPageEngine(encrypt_key='encryption key',resource_url_
key='foo.oracle.com',use_port=9999,use_scheme='page_engine_1',
x509certfile='file')

listPortalWebcacheConfigAttributes

コマンド カテゴリ : コンフィグレーション コマンド

WLST の使用状況 : オンライン

説明

Portal リポジトリで使用される WebCache コンフィグレーションの属性を一覧表示します。

構文

listPortalWebcacheConfigAttributes ([dad_name])

引数	定義
dad_name	省略可能。データベース アクセス記述子の名前。デフォルトの DAD 名は、「portal」です。

例

次の例では、Portal リポジトリで使用される WebCache コンフィグレーションを示します。無効化メッセージが送信される WebCache ホスト名、無効化ユーザ名、パスワードおよび無効化メッセージの送信先の無効化ポートが表示されます。

listPortalWebcacheConfigAttributes(dad_name='portal1')listPortalWebcacheConfigAttributes('portal1')
---------------
WebCacheConfig
---------------
WebCache Host: foo.oracle.com
WebCache Invalidation Password: invalidator
WebCache Invalidation Port: 6523
WebCache Invalidation User: invalidator

listPortalSiteConfigAttributes

コマンド カテゴリ : コンフィグレーション コマンド

WLST の使用状況 : オンライン

説明

ポータル サイトのコンフィグレーションの属性を示します。

構文

listPortalSiteConfigAttributes ([dad_name])

引数	定義
dad_name	省略可能。データベース アクセス記述子の名前。デフォルトの DAD 名は、「portal」です。

例

次の例では、ポータル サイトのコンフィグレーションを示します。サイト プロトコルは true または false に設定できます。サイト プロトコルに false が設定される場合、HTTP はプロトコルで、サイト プロトコルに true が設定される場合、HTTPS はプロトコルです。サイト ホスト名およびポート番号も示します。

listPortalSiteConfigAttributes(dad_name='portal1')
listPortalSiteConfigAttributes('portal1')
 
---------------
SiteConfig
---------------
Site Protocol: false
Site Host: foo.oracle.com
Site Port: 8090

listPortalOIDConfigAttributes

コマンド カテゴリ : コンフィグレーション コマンド

WLST の使用状況 : オンライン

説明

Oracle Internet Directory コンフィグレーションの属性を一覧表示します。

構文

listPortalOIDConfigAttributes ([dad_name])

引数	定義
dad_name	省略可能。データベース アクセス記述子の名前。デフォルトの DAD 名は、「portal」です。

例

次の例では、Oracle Internet Directory ホスト名およびポート番号を含む Oracle Internet Directory データを示します。

listPortalOIDConfigAttributes(dad_name='portal1')
listPortalOIDConfigAttributes('portal1')
 
---------------
OidConfig
---------------
OID Port: 13060
OID Host: foo.oracle.com

setPortalWebcacheConfig

コマンド カテゴリ : コンフィグレーション コマンド

WLST の使用状況 : オンライン

説明

WebCache では、キャッシング、ページの組立ておよび圧縮機能が提供されています。Oracle WebCacheでは、静的な Web コンテンツと動的な Web コンテンツの両方の配信が高速化され、Oracle Fusion Middleware のロード バランシングおよびフェイルオーバの機能が提供されます。

このコマンドは WebCache コンフィグレーションを更新します。

構文

setPortalWebcacheConfig([dad_name], [host], [inv_port], [inv_user], 
[inv_passwd])

引数	定義
dad_name	省略可能。データベース アクセス記述子の名前。デフォルトの DAD 名は、「portal」です。
host	省略可能。無効化メッセージが送信される WebCache ホストの名前。
inv_port	省略可能。無効化メッセージが送信される WebCache ポート番号。
inv_user	省略可能。無効化メッセージの送信に使用されるユーザ名。
inv_password	省略可能。WebCache 無効化パスワード。

例

次の例では、指定された値に基づいて WebCache コンフィグレーションを更新します。

setPortalWebcacheConfig(dad_name='portal1',host='foo.oracle.com',
inv_port= '6523',inv_user= 'invalidator',inv_passwd=' invalidator')

setPortalOIDConfig

コマンド カテゴリ : コンフィグレーション コマンド

WLST の使用状況 : オンライン

説明

Oracle Internet Directory コンフィグレーションの属性を更新します。

構文

setPortalOIDConfig ([dad_name], [host], [port], [protocol], [admin_user], 
[admin_passwd])

引数	定義
dad_name	省略可能。データベース アクセス記述子の名前。デフォルトの DAD 名は、「portal」です。
host	省略可能。Oracle Internet Directory のホスト名。
port	省略可能。Oracle Internet Directory のポート番号。
protocol	省略可能。Oracle Internet Directory のプロトコル。
admin_user	省略可能。Oracle Internet Directory 管理者の名前。
admin_passwd	省略可能。Oracle Internet Directory 管理者のパスワード。

例

次の例では、指定された値に基づいて OID コンフィグレーションを更新します。

setPortalOIDConfig(dad_name='portal1',
host='foo.oracle.com',port='13060',protocol=false,
admin_user='cn=orcladmin',admin_passwd='oracle1')

setPortalMidtierConfig

コマンド カテゴリ : コンフィグレーション コマンド

WLST の使用状況 : オンライン

説明

最新のポータル中間層コンフィグレーションでポータル リポジトリを更新します。

構文

setPortalMidtierConfig([dad_name], [ohs_host], [ohs_port], [ohs_protocol], 
[webcache_host], [webcache_inv_user], [webcache_inv_port], 
[webcache_inv_passwd])

引数	定義
dad_name	省略可能。データベース アクセス記述子の名前。デフォルトの DAD 名は、「portal」です。
ohs_host	省略可能。Oracle HTTP Server ホスト名。
ohs_port	省略可能。Oracle HTTP Server ポート番号。
ohs_protocol	省略可能。Oracle HTTP Server プロトコル。
webcache_host	省略可能。無効化メッセージが送信される WebCache ホストの名前。
webcache_inv_user	省略可能。無効化メッセージを送信するために使用する WebCache ユーザ名。
webcache_inv_port	省略可能。無効化メッセージが送信される WebCache ポート番号。
webcache_inv_passwd	省略可能。WebCache 無効化パスワード。

例

次の例では、指定された値に基づいてポータル中間層コンフィグレーションを更新します。

setPortalMidtierConfig(dad_name='portal1',ohs_host='foo.oracle.com',
ohs_port='8090',ohs_protocol=false,webcache_host='foo.oracle.com',
webcache_inv_user= 'invalidator',webcache_inv_port='6523',
webcache_inv_passwd='invalidator')