| Sun ONE Portal Server 6.2 管理者ガイド |
第 4 章
ポータルデスクトップサービスの管理この章では、Sun��ONE Portal Server のデスクトップサービスの管理方法について説明します。
この章で説明する内容は次のとおりです。
デスクトップの概要ここでは、デスクトップコンポーネントとその基本構造、およびその管理方法について説明します。
デスクトップ用語集
表 4-1 は、デスクトップに関連する用語の説明を示しています。
最初の列は用語を示し、2 番目の列は用語の定義を示します。
ポータルデスクトップのアーキテクチャとコンテナ階層
デスクトップは、Sun ONE Portal Server のプライマリエンドユーザーインタフェースです。デスクトップはサーブレットで実装され、さまざまな API とユーティリティ (SunTM ONE Identity Server API、リソースバンドル、プロパティファイル、およびメールサーバーを始めとするバックエンドサーバーなど) によってサポートされています。
デスクトップは、プロバイダアプリケーションプログラミングインタフェース (PAPI) を使用してコンテンツを拡張、集約するメカニズムを提供します。コンテンツプロバイダ、またはプロバイダは、コンテナ階層、および一部のチャネルを構築するための基本的なビルディングブロックを有効にします。通常、チャネルは行と列で編成しますが、コンテナチャネルを実装することで、この配備を変更することもできます。プロバイダは、コンテンツを生成するプログラムエンティティで、チャネル中に表示されます。生成したコンテンツは、ページ全体、フレーム、またはチャネルなどの任意のマークアップで構成できます。
ポータルのコンテンツ量が増加した場合にも、ポータルの構成、開発、および一般ユーザーによる使用実績は、参照するコンテンツのグループの格納方法によって簡略化できます。Sun ONE Portal Server は、コンテンツの集約においてコンテナプロバイダの柔軟で拡張性の高いセットを提供します。
図 4-1 は、デスクトップコンテナ階層の例を示しています。この図では、タブコンテナが最上位コンテナです。タブコンテナには、2 つのタブチャネルであるタブ 1 とタブ 2 があります。タブ 2 はテーブルコンテナで、内部に 5 つのチャネルを格納します。
図 4-1 ポータルデスクトップのコンテナ階層の例
図 4-1 は、次の格納方式を示しています。
ユーザー定義のチャネル
それぞれのタブコンテナにはコンテンツリンクが含まれます。コンテンツリンクを選択すると、ユーザーが現在のタブのコンテナに表示するチャネルを選択できるページが表示されます。このリリースでは、このページの右上に「新しいチャネルの作成」というリンクが追加されています。「新しいチャネルの作成」リンクを選択すると、ユーザーが新しいチャネルを作成するためのページが表示されます。ただし、ユーザーが作成できるチャネルは管理者が定義することができます。
表示されるページから新しいチャネルを作成するには、ユーザーはフォームに表 4-2 に示される情報を指定する必要があります。
ユーザー定義のチャネルを作成すると、コンテンツページに「チャネルの削除」リンクが表示されるようになります。ユーザーがリンクをクリックすると、ユーザーが作成したすべてのチャネルが表示され、チャネルを削除することができます。
ポータルデスクトッププロバイダ
Sun ONE Portal Server は、次の 2 つのタイプのプロバイダを使用します。
ポータルデスクトップは、コンテンツ、プロバイダ、ポートレット、チャネルデータを格納するためにディスプレイプロファイルを使用します。詳細は、第 5 章「ディスプレイプロファイルの管理」を参照してください。
ポータルデスクトップサービス
デスクトップサービスは、Sun ONE Identity Server サービスを使用して、各組織またはサブ組織のアプリケーションとユーザー固有の属性を格納します。管理者は、次にディスプレイプロファイルポリシーを作成し、それをユーザーに割り当てます。Sun ONE Identity Server 管理コンソールを使用して、デスクトップ属性を修正することもできます。詳細は、付録 C 「ポータルデスクトップの属性」を参照してください。
サンプルデスクトップ
Sun ONE Portal Server のサンプルデスクトップには、次のチャネルが含まれます。
これらのチャネルは、サンプルポータルに合わせてカスタマイズおよび設定されています。配備するには、ユーザーインタフェースの修正が必要になることがあります。
ポータルデスクトップのカスタマイズ
Sun ONE Portal Server を配備する場合、ポータルの開発と、カスタマイズが主な作業になります。まず、プロバイダ、チャネル、およびコンテナチャネルを作成、拡張してからオンラインヘルプを配備し、見た目と使い心地などを変更します。必要に応じて、サンプルデスクトップを、サイトのポータルをカスタマイズする際の出発点として使用できます。ポータルのカスタマイズの詳細については、『Sun ONE Portal Server 6.1 Desktop Customization Guide』を参照してください。
チャネルのホット配備の概要Sun ONE Portal Server を使用すると、再起動せずに稼動中のシステムでプロバイダとチャネルを配備できます。すなわち「ホット配備」が可能です。この場合、ユーザーセッションに割り込みが起こりません。
ホット配備を実現する 3 つのテクノロジは次のとおりです。
プロバイダアーカイブの概要par ユーティリティで、チャネル、ポートレット、プロバイダ、および関連するすべてのファイルを Sun ONE Portal Server システムにパッケージ化したり、システムから移動したりすることができます。チャネル、ポートレット、プロバイダは .par ファイル形式で格納されます。.par ファイルにインクルードされるファイルは次のとおりです。
ポータルデスクトップサービスの管理デスクトップは、ユーザーのディスプレイプロファイルのマージしたセットに含まれるすべてのドキュメントをさらにマージし、それを使用してユーザーのデスクトップを構成します。ディスプレイプロファイルのマージしたセットには、ユーザーに関連するすべてのディスプレイプロファイルドキュメントが含まれます。ディスプレイプロファイルは、Sun ONE Identity Server 組織ツリーの異なるレベルで定義されます。ツリーのさまざまなレベルのディスプレイプロファイルドキュメントをマージまたは結合して、ユーザーのディスプレイプロファイルを作成します。たとえば、ユーザーのディスプレイプロファイルを形成するユーザーのディスプレイプロファイルドキュメントは、ロールディスプレイプロファイルドキュメント (存在する場合)、組織のディスプレイプロファイルドキュメント、およびグローバルなディスプレイプロファイルドキュメントとマージされます。
デスクトップディスプレイプロファイルとその他の設定データは、Sun ONE Identity Server サービス管理フレームワーク内にあるポータルデスクトップサービスのサービス属性として定義されます。組織が Sun ONE Identity Server 管理コンソールでポータルデスクトップサービスを登録する場合、組織内のすべてのユーザーはユーザープロファイルのポータルデスクトップサービス属性を継承します。この場合、ポータルデスクトップはこれらの属性を照会し、情報をどのようにポータルデスクトップに集約して表示するかを決定します。
デフォルトでは、ポリシー設定サービスは自動的に最上位の組織に登録されます。サブ組織は、親組織とは別にポリシーサービスを登録する必要があります。作成したポリシーサービスは、すべての組織に登録する必要があります。
Sun ONE Identity Server 組織のユーザーに対してポータルデスクトップサービスを設定するために必要な操作の概要は、次のとおりです。
- 組織のポリシーサービスを登録します
- ピアまたはサブ組織の参照ポリシーを作成します。
- ピアまたはサブ組織の通常のポリシーを作成します。
- デフォルトのリダイレクト先 URL を割り当てます。
- デスクトップサービス属性をカスタマイズします。
注
サンプルポータルをインストールすると、インストーラはサンプルに必要 なディスプレイプロファイル XML ファイルをすべてインストールします。 Sun ONE Identity Server コンソール、またはコマンドラインインタフェー スを使用すると、プロファイルをカスタマイズできます。詳細は、第 5 章 「ディスプレイプロファイルの管理」を参照してください。
デフォルトでは、ポリシー設定サービスは自動的に最上位の組織に登録されます。サブ組織は、親組織とは別にポリシーサービスを登録する必要があります。作成したポリシーサービスは、すべての組織に登録する必要があります。ポリシーを使用するための手順の概要は、次のとおりです。
- 組織のポリシーサービスを登録します (インストール時に指定した組織については、これは自動的に行われます)。サブ組織は、親サービスを継承しないため、サブ組織のポリシーサービスを登録する必要があります。詳細は、「サブ組織のポリシーサービスを登録するには」を参照してください。
- ピアまたはサブ組織の参照ポリシーを作成します。組織のポリシーに関する定義と決定を別の組織に委託することができます (リソースのポリシー定義は別のポリシー製品に委託されます)。この、ポリシーの作成と評価に関するポリシー委任は、参照ポリシーによって制御されます。これは、規則と参照自体から構成されます。リソースを必要としないアクションがポリシーサービスに含まれる場合、サブ組織の参照ポリシーを作成することはできません。詳細は、「サブ組織の参照ポリシーを作成するには」を参照してください。
- ピアまたはサブ組織の通常のポリシーを作成します。アクセス権の定義には通常のポリシーを使用します。通常のポリシーは、複数の規則、サブジェクト、条件から構成されます。詳細は、「サブ組織の通常のポリシーを作成するには」を参照してください。
サブ組織のポリシーサービスを登録するには
サブ組織は、親サービスを継承しないため、サブ組織のポリシーサービスを登録する必要があります。
- Sun ONE Identity Server 管理コンソールに管理者としてログインします。
デフォルトでは、ロケーションパネルでは「アイデンティティ管理」が選択され、ナビゲーションパネルには作成済みのすべての組織が表示されています。
- デスクトップサービスを登録する組織を選択します。
- ナビゲーションパネルの「表示」メニューから「サービス」を選択します。
- ナビゲーションパネルで「登録」をクリックします。
使用できるサービスのリストがデータパネルに表示されます。
- 「Portal Server 設定」の「ポータルデスクトップ」チェックボックスにチェックマークを付けて、「登録」をクリックします。
ナビゲーションパネルが、「Portal Server 設定」に登録したデスクトップサービスで更新されます。
- ナビゲーションパネルの「表示」メニューから「サービス」を選択します。
- ナビゲーションパネルの「ポータルデスクトップ」の隣にあるプロパティの矢印を選択します。
- このとき、データパネルのメッセージボックスに、デスクトップサービスにサービステンプレートを作成する必要があるかどうかを確認するメッセージが表示されます。メッセージボックス内の「作成」をクリックし、テンプレートを作成します。
- ページを送信してテンプレートが作成されると、データパネルにデスクトップサービス属性とデフォルト値があればその一覧が表示されます。必要に応じて値を修正します。完了したら、「保存」を選択してサービステンプレートの最新の値を保存します。
新規に作成したサービステンプレートのディスプレイプロファイルは、「サービス設定」にある「ポータルデスクトップ」サービスの「ダイナミック」セクションに入力した値を取ります。それらの値が空白の場合、この新規テンプレートのディスプレイプロファイルも空白になります。
サブ組織の参照ポリシーを作成するには
組織のポリシーに関する定義と決定を別の組織に委託することができます。この、ポリシーの作成と評価に関するポリシー委任は、参照ポリシーによって制御されます。これは、規則と参照自体から構成されます。参照は、規則内のリソースとして親組織を定義する必要があり、参照内の値として SubOrgReferral に組織名が含まれている必要があります。
- Sun ONE Identity Server 管理コンソールに管理者としてログインします。
デフォルトでは、ロケーションパネルでは「アイデンティティ管理」が選択され、ナビゲーションパネルには作成済みのすべての組織が表示されています。
- ナビゲーションパネルで「アイデンティティ管理」を選択します。
- 「表示」メニューから「ポリシー」を選択します。
- 「新規」をクリックし、新しいポリシーを作成します。
ポリシーの作成ページがデータパネルに表示されます。
- 「名前」には、SubOrgReferral_Desktop を入力します。「ポリシータイプ」で「参照」が選択されていることを確認します。「作成」をクリックします。
- 「サービス」から「ポータルデスクトップ」を選択し、「次へ」をクリックします。
- データパネルの「表示」メニューから「ルール」を選択し、「追加」をクリックします。「ポータルデスクトップ」が選択されていることを確認し、「次へ」をクリックします。
ルールの追加テンプレートがデータパネルに表示されます。
- 「ルール名」に DesktopRule と入力し、「作成」をクリックします。
- データパネルの「表示」メニューから「参照」を選択し、「追加」をクリックします。
「新規リフェラル」テンプレートがデータパネルに表示されます。
- 「名前」に SubOrgReferral_Desktop と入力します。
データパネルで「値」にサブ組織の名前が選択されていることを確認し、「作成」をクリックしてポリシーの設定を完了します。
- データパネルで「保存」をクリックします。
データが保存されると、「ポリシープロパティが保存されました。」というメッセージが表示されます。
サブ組織の通常のポリシーを作成するには
アクセス権の定義には通常のポリシーを使用します。通常のポリシーは、複数の規則、サブジェクト、条件から構成されます。
- Sun ONE Identity Server 管理コンソールに管理者としてログインします。
デフォルトでは、ロケーションパネルでは「アイデンティティ管理」が選択され、ナビゲーションパネルには作成済みのすべての組織が表示されています。
- ポリシーを作成する組織またはサブ組織に移動します。
作成したすべての組織がナビゲーションパネルに表示されます。
- 「表示」メニューから「ポリシー」を選択します。
その組織のポリシーが表示されます。
- ナビゲーションパネルで「新規」を選択します。「新規ポリシー」ページがデータパネルに表示されます。
- 「名前」に SubOrgNormal_Desktop と入力します。「ポリシータイプ」で「標準」が選択されていることを確認します。「作成」をクリックします。
- データパネルの「表示」メニューから「ルール」を選択し、「新規」をクリックします。ルールの追加テンプレートがデータパネルに表示されます。
- 「サービス」メニューから「ポータルデスクトップ」を選択し、「次へ」をクリックします。「ルール名」に DesktopRule と入力します。「NetMail 実行権限」にチェックマークが付けられていることを確認します。
- 「サービス」メニューから「ポータルデスクトップ」を選択し、「次へ」をクリックします。「NetMail 実行権限」にチェックマークが付けられていることを確認します。
- 「タイプ」メニューからサブジェクトのタイプを選択し、「次へ」をクリックしてサブジェクトの設定を完了します。
- データパネルの「表示」メニューから「サブジェクト」を選択し、「新規」をクリックします。「サブジェクトを追加」ページがデータパネルに表示されます。
- 「作成」をクリックして、ポリシーの設定を完了します。
データが保存されると、「ポリシープロパティが保存されました。」というメッセージが表示されます。
ログインユーザーをポータルデスクトップ URL に正しくリダイレクトするには
ログインに成功すると、組織内のユーザーはデフォルトでデスクトップサービスの属性、および値を受け取ります。これらの値はデスクトップサーブレットによって照会され、組織内の全ユーザーのポータルデスクトップコンテンツが決定されます。ユーザーがログインに成功したあと、Sun ONE Identity Server がポータルデスクトップサーブレットを自動的に呼び出すようにするには、デフォルトのリダイレクト URL をポータルデスクトップ URL に変更します。
ポータルデスクトップ URL にリダイレクトされるように、特定の組織のデフォルトリダイレクトを設定するには、次の手順に従います。
- Sun ONE Identity Server 管理コンソールに管理者としてログインします。
デフォルトでは、ロケーションパネルでは「アイデンティティ管理」が選択され、ナビゲーションパネルには作成済みのすべての組織が表示されています。
- ポータルデスクトップ URL を設定する組織を選択します。
- 「表示」メニューから「サービス」を選びます。
- ナビゲーションパネルの「コア」の隣にあるプロパティの矢印を選択します。
- データパネルで、「デフォルト成功ログイン」という属性を探します。
- 「デフォルト成功ログイン」の値をデスクトップサーブレットの URL に設定します。たとえば、/portal/dt はサンプルデスクトップの URL です。
- 「保存」をクリックします。
- デスクトップにログインして、デフォルトのポータルリダイレクト URL を確認します。
ログインユーザーをポータルデスクトップ URL に正しくリダイレクトするには (グローバル)
グローバル属性に適用される値は、Sun ONE Identity Server 設定に適用され、また新規に作成されたすべての組織に継承されます。
デフォルトリダイレクト URL をポータルデスクトップ URL にグローバルに設定するには、次の手順に従います。
ポータルデスクトップサービス属性の値を修正するには
サービス属性を修正することで、ポータルデスクトップサービスをカスタマイズできます。
- Sun ONE Identity Server 管理コンソールに管理者としてログインします。
デフォルトでは、ロケーションパネルでは「アイデンティティ管理」が選択され、ナビゲーションパネルには作成済みのすべての組織が表示されています。
- デスクトップ属性を修正する組織を選択します。
- ナビゲーションパネルの「デスクトップ」の隣にあるプロパティの矢印を選択します。
ディスプレイプロファイル XML を含む、ポータルデスクトップサービス属性の一覧がデータパネルに表示されます。
- サービス属性値を修正します。
属性の詳細については、付録 C 「ポータルデスクトップの属性」を参照してください。
- 完了したら、「保存」を選択します。
変更は、特定のサブ組織またはロールのユーザーだけに反映されます。
ポータルデスクトップサービス属性の値を修正するには (グローバル)
グローバルデスクトップサービスの属性値、すなわち、後でデスクトップサービスに登録する組織すべてに反映させる属性値を修正することもできます。
グローバル属性に適用される値は、Sun ONE Identity Server 設定に適用され、また今後構成されるすべての組織に継承されます。
- Sun ONE Identity Server 管理コンソールに管理者としてログインします。
デフォルトでは、ロケーションパネルでは「アイデンティティ管理」が選択され、ナビゲーションパネルには作成済みのすべての組織が表示されています。
- ロケーションパネルで「サービス設定」をクリックします。
- ナビゲーションパネルの「デスクトップ」の隣にあるプロパティの矢印を選択します。
ディスプレイプロファイル XML を含むグローバルデスクトップサービス属性の一覧が、データパネルに表示されます。
- サービス属性値を修正します。
属性の詳細については、付録 C 「ポータルデスクトップの属性」を参照してください。
- 完了したら、「保存」を選択します。
この変更は、今後、デスクトップサービスに登録するすべての組織に影響します。
サンプルポータルデスクトップにアクセスするには
- Sun ONE Identity Server 管理コンソールからログアウトします。
- 次の URL を使用してユーザーアカウント (amadmin ユーザーではない) でログインします。
http://server:port/portal/dt
ユーザーアカウントを作成する必要がある場合は、第 2 章「認証、ユーザー、およびサービスの管理」を参照してください。
デスクトップログを確認するには
ポータルデスクトップエラーはデバッグログファイルに記録されます。デフォルトでは、これらログファイルの位置は次のとおりです。
これらのログファイルのエラーを調べます。次に、例を示します。このエラーは認証されていないユーザーがポータルデスクトップを実行しようとしたことを示します。
ポートレットの管理ポートレットの管理には、SunTM ONE Identity Server 管理コンソールを使用します。管理コンソールには、ポートレットからポートレットチャネルを作成するページ、およびポートレットチャネルの設定を変更するページが用意されています。ポートレット Web アプリケーションを Web コンテナに配備する (または配備解除する) ときは、pdeploy というコマンドラインツールを使用します (「コマンドラインユーティリティ」を参照)。
注
少なくとも 1 つのセッションが有効なポートレットを含むポータルページにクライアント要 求がアクセスするときは、そのポータルページのすべてのポートレットを 1 つのポートレッ トアプリケーションとしてパッケージ化することを強くお勧めします。パッケージしない場 合、セッション作成の結果が 1 つに特定されなくなります。
ポートレットからチャネルを作成するには
特定コンテナのポートレットからチャネルを作成するには
- Sun ONE Identity Server 管理コンソールにログインし、組織を選択します。
- ナビゲーションメニューの「表示」の下で「サービス」を選択します。
- 「Portal Server 設定」の下で「ポータルデスクトップ」サービスを選択します。
- 「チャネルおよびコンテナの管理」を選択します。
- ポートレットチャネルを作成するコンテナのリンクを選択します。
コンテナを管理するためのページが表示されます。
- 「チャネル」の下の「新規ポートレットチャネル」ボタンを選択します。
ポートレットチャネルを作成、追加するためのページが表示されます。.
- 「チャネルの追加」ページに次の情報を指定します。
- 適切なラジオボタンを選択し、エンドユーザーがそのチャネルを使用できるか、またはデスクトップ上で使用、表示できるかを指定します。
- 「了解」ボタンを選択します。
「チャネル」の下のチャネルリスト、および「チャネルおよびコンテナの管理」ページの「使用可能および表示可能」の下にチャネルが追加されます。
コンテナにポートレットチャネルを追加するには
- Sun ONE Identity Server 管理コンソールにログインし、組織を選択します。
- ナビゲーションパネルの「表示」の下で「サービス」を選択します。
- 「Portal Server 設定」から「ポータルデスクトップ」を選択します。
- 「チャネルおよびコンテナの管理」を選択します。
- 新たに作成するポートレットチャネルの追加先となるコンテナへのリンクを選択します。
コンテナを管理するためのページが表示されます。
- チャネル管理に追加するポートレットチャネルを選択し、「追加」を選択します。
これにより、選択しているコンテナで使用、表示できるチャネルのリストに、選択したポートレットチャネルが追加されます。
- 「チャネル管理」の下の「保存」ボタンをクリックし、新しい設定を保存します。
ポートレットチャネルの設定とプロパティを編集するには
ポートレットの設定は、portlet.xml ファイルに定義されます。
<portlet-preferences>
<preference>
<name>foo</name>
<value>apple</value>
</preference>
<preference>
<name>bar</name>
<value>orange</value>
<value>grape</value>
<read-only>true</read-only>
</preference>
</portlet-preferences>
これは、次のディスプレイプロファイルにマッピングされます。
<Collection name="__Portlet__AdditionalPreferences"/>
<Collection name="__Portlet__PreferenceProperties">
<Collection name="default">
<String name="foo" value="|apple"/>
<String name="bar" value="|orange|grape"/>
</Collection>
<Collection name="isReadOnly">
<Boolean name="foo" value="false"/>
<Boolean name="bar" value="true"/>
</Collection>
</Collection>
<String name="__Portlet__foo" value="|apple"/>
<String name="__Portlet__bar" value="|orange|grape"/>
実行時に追加される設定を保持するために、空のコレクション __Portlet__AdditionalPreferences が作成されます。コレクション __Portlet__PreferenceProperties には、default と isReadOnly という 2 つのコレクションが含まれます。default コレクションには、portlet.xml に定義されるデフォルト値が格納されます。default コレクションと似ている isReadOnly コレクションには、ブール型のプロパティを使用する設定の読み取り専用フラグが格納されます。
portlet.xml に含まれる各設定は、default コレクション内に対応する String プロパティを持ちます。このプロパティの名前は、設定名です。String プロパティの値は、portlet.xml に定義されているデフォルト値で、先頭に「|」という文字が付けられ、複数の値は「|」で区切られます。次に、各設定は設定の現在値を格納する String プロパティで表わされます。このプロパティの名前は、設定名で、先頭に __Portlet__ という文字列が付けられます。プロパティの値は、現在のプロパティ値で、先頭に「|」という文字が付けられ、複数の値は「|」で区切られます。
- Sun ONE Identity Server 管理コンソールにログインし、ドメインを選択します。
- ナビゲーションパネルの「表示」の下で「サービス」を選択します。
- 「Portal Server 設定」から「ポータルデスクトップ」を選択します。
- 編集するポートレットチャネルの「プロパティの編集」リンクを選択します。
- 「チャネルの編集」ページが表示されます。チャネル編集ページには、ポートレットエンティティのポートレット設定が表示されます。
- 設定を変更し、「保存」を選択して変更内容を保存します。
- 設定のデフォルト値を変更するときは、編集する設定の「プロパティの編集」リンクをクリックします。プロパティは、「チャネルの編集」ページで編集できます。
par ファイルの管理par ユーティリティで、Sun ONE Portal Server 間でプロバイダまたはチャネルを送信したり移動したりすることができます。par ユーティリティは、.par ファイルと呼ばれる特定のパッケージメカニズムを作成して、チャネル、ポートレット、プロバイダをサーバー間で送受信します。.par ファイルは .jar ファイル形式の拡張形式で、マニフェスト情報を追加することで、ターゲットサーバーの Sun ONE Portal Server ディスプレイプロファイルに配備情報と XML ドキュメントを送ります。
par コマンドラインユーティリティを使用して par ファイルを作成、修正、配備します。export サブコマンドを使用すると par ファイルを作成、または修正できます。import サブコマンドを使用すると、Sun ONE Portal Server でプロバイダ、チャネル、ポートレットをインポートまたは配備できます。describe サブコマンドを使用すると、par ファイルの内容の説明を参照できます。par コマンドの構文については、「par」を参照してください。
par ユーティリティを使用するには、エクスポートまたはインポートするファイルがある Sun ONE Portal Server に、superuser としてログインする必要があります。エクスポートする場合、チャネル、ポートレット、またはプロバイダが要求するすべてのファイルを確実にエクスポートする必要があります。たとえば、チャネルにはスタティックなコンテンツファイルを、プロバイダにはプロバイダが使用するすべてのクラスファイルをインクルードする必要があります。コマンドラインで par ファイルに含まれるすべてのデータを指定すると操作が煩雑になるので、データを示す行を持つ簡単なテキストファイルを作成し、par ユーティリティでこの「エクスポートファイル」を呼び出します。詳細は、第 4 章「ポータルデスクトップサービスの管理」を参照してください。
新規の par ファイルを作成するには
新規の par ファイルを作成してから、次の手順でチャネル、ポートレット、またはプロバイダをエクスポートします。
- チャネル、ポートレット、またはプロバイダのエクスポート元となる Sun ONE Portal Server にログインします。
- スクリプトがインストールされているディレクトリに移動します。次のように指定します。
cd BaseDir/SUNWps/bin
- コマンドラインで par export コマンドとサブコマンドを次の引数を含めて入力します。作成する par ファイル名、エクスポートするディスプレイプロファイルドキュメントに対応するディレクトリサーバー名、および任意の数の (少なくとも 1 つ) のエクスポートファイルや from 以下に指定した引数を指定します。たとえば、o=sesta.com,o=isp から mychannel.par ファイルへ mychannel チャネルをエクスポートするには、次のコマンドを入力します。
./par export mychannel.par "o=sesta.com,o=isp" from:channel mychannel
構文については、第 14 章「コマンドラインユーティリティ」を参照してください。
既存の par ファイルを修正するには
既存の par ファイルを修正して、次の手順でチャネル、ポートレット、またはプロバイダをエクスポートします。
- チャネル、ポートレット、またはプロバイダのエクスポート元となる Sun ONE Portal Server にログインします。
- スクリプトがインストールされているディレクトリに移動します。次のように指定します。
cd BaseDir/SUNWps/bin
- コマンドラインで、modify オプションを使用して par export コマンドとサブコマンドを次の引数とともに入力します。修正する par ファイル名、エクスポートするディスプレイプロファイルドキュメントに対応するディレクトリサーバー名、および任意の数の (少なくとも 1 つ) のエクスポートファイル、または from 以下に指定した引数です。たとえば、mychannel.par ファイルを修正してスタティックコンテンツファイル /mycontent.html を含めるには、次のコマンドを入力します。
./par export --modify mychannel.par "dc=sesta,dc=com" "from= file /mycontent.html"
par ファイルを配備するには
Sun ONE Portal Server へ par ファイルをインポートし、次の手順でプロバイダまたはチャネルをシステムに配備します。
- プロバイダまたはチャネルに par ファイルをコピーして Sun ONE Portal Server へインポートし、そこにプロバイダまたはチャネルを配備します。
- チャネル、ポートレット、またはプロバイダのインポート先となる Sun ONE Portal Server へログインします。
- スクリプトがインストールされているディレクトリに移動します。次のように指定します。
cd BaseDir/SUNWps/bin
- コマンドラインで par import コマンドとサブコマンドを次の引数を含めて入力します。インポートする par ファイル名、エクスポートするディスプレイプロファイルドキュメントに対応するディレクトリサーバー名です。たとえば、mychannel.par ファイルをインポートするには、次のコマンドを入力します。
./par import --auto myfile.par "do=sesta,dc=com"
