33 ポータル、テンプレート、アセットおよび拡張機能のデプロイ
注意:
12c (12.2.1.3.0)からは、Oracle WebCenter PortalでのJive機能(お知らせとディスカッション)のサポートは非推奨になりました。 以前のリリースからアップグレードする場合、これらの機能はアップグレード対象の既存のインストールで引き続き使用できます。
権限:
この章の内容は、システム管理者を対象としています。
ポータル、テンプレート、アセット、接続および拡張機能のデプロイに必要なロールと権限の詳細は、「WebCenter Portalのライフ・サイクル操作の実行に必要な権限」を参照してください。
「管理操作、ロールおよびツールの理解」も参照してください。
ポータルのデプロイ
この項には次のトピックが含まれます:
ポータルのデプロイメントについて
ポータルを別のポータル・サーバーにデプロイする場合、ターゲット・サーバーにソース・ポータルをコピーして、ソース・ポータルのデータの全部または一部を含めるよう選択できます。
ポータルの初期デプロイメントの後、ポータルを再デプロイすること、またはポータルの変更のみをターゲットに伝播することを選択できます。ポータルを再デプロイする場合、これは単純に削除されて新しいポータルとして再作成されます。ポータル伝播では、ポータルに加えられた増分変更のみがターゲット・サーバーにプッシュされます。
ポータルは、次の方法でデプロイできます。
-
ポータルの直接デプロイメント - ターゲット・サーバーへの直接接続が存在する場合、WebCenter Portal管理を使用してポータルをターゲット・サーバーにデプロイできます。
deployWebCenterPortal
のWLSTコマンドを使用してポータルをターゲット・サーバーに直接デプロイすることもできます。詳細は、「WebCenter Portalを使用したポータルの直接デプロイ」および「WLSTを使用したポータルの直接デプロイ」を参照してください。 -
ポータル・アーカイブのデプロイメント - WebCenter Portal管理を使用して、ソース・ポータルのアーカイブ(
.par
ファイル)をエクスポートして、アーカイブ・ポータルをターゲット・サーバーにインポートできます。WLSTコマンドを使用して、ポータルをアーカイブにエクスポートして、ポータルをファイルからインポートすることもできます。詳細は、「ポータル・アーカイブのインポートとエクスポート」を参照してください。
ポータルとともに常にデプロイされる情報
-
ポータル・ページ
- ポータル・アセット: ページ・テンプレート、リソース・カタログ、スキン、ページ・スタイル、コンテンツ・プレゼンタ表示テンプレート、タスク・フロー・スタイル、タスク・フロー、レイアウト、ページレット、データ・コントロール、視覚化テンプレート、データ視覚化(依存ビジネス・オブジェクトとデータ・ソースを含む)、ビジネス・オブジェクト、データ・ソース(その接続を含む)
-
ポータルのアクティビティおよび使用状況データ: アクティビティ・ストリーム、カレンダ・イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイルおよびアンケート
-
ポータルのセキュリティ・データ: ポータル・ロールと権限、およびメンバーの詳細とそのロールの割当て
ポータルとともにオプションでデプロイ可能な情報
-
ポータルのコンテンツ: ポータルのドキュメントおよび関連するコンテンツが、Content Serverのポータルのコンテンツ・フォルダに配置されます。ポータルのデプロイメント中にコンテンツ・フォルダを移動しない場合、WebCenter Content Serverの移行ツールを使用してフォルダをターゲットに手動で移動できます。詳細は、『Oracle WebCenter Contentの管理』のシステムの移行とアーカイブに関する項を参照してください。
ポータルのデプロイメントには、ポータル独自のコンテンツ・フォルダの外部に格納されているコンテンツは含められません。ポータルにポータル・アセット、ポータル・ページ、コンテンツ・プレゼンタ表示テンプレート、またはポータルのコンテンツ・フォルダの外部のコンテンツを参照する他のコンポーネントが含まれる場合、それらのコンテンツを手動で移動するか、ターゲットがソースと同じコンテンツにアクセスできるようにする必要があります。ポータルを別のターゲットに移動する場合、コンテンツ・プレゼンタのデータ参照は、Content Serverの接続名とルート・フォルダ名がソースとターゲットの両方で同じ場合のみ維持されます。
-
共有アセット: ポータルのデプロイ中に、ポータルによって使用されるすべての共有アセットをデプロイすることを選択できます。
-
共有ライブラリ: ポータルのデプロイ中に、ポータルによって使用される共有ライブラリをデプロイすることを選択できます。共有ライブラリをデプロイすることを選択した場合は、デプロイされるメインの共有ライブラリは
extend.spaces.webapp
になり、これを他のライブラリに依存するようにできます。デプロイメントの一部として、メインの共有ライブラリのすべての新しいバージョン(新規作成または更新)の依存ライブラリも含められます。ただし、これは依存ライブラリの最初のレベルのみに実行されます。 たとえば、extend.spaces.webapp
はCustomSharedLibrary1
に依存し、CustomSharedLibrary1
はCustomSharedLibrary2
に依存するとします。CustomSharedLibrary1
とCustomSharedLibrary2
の両方で更新されたバージョンが利用できる場合は、共有ライブラリのデプロイメントの一部として、CustomSharedLibrary1
のみが含められます。
ポータルのデプロイメントで含められない情報
一部のポータル情報は、外部に格納されているため、ポータルと同時にデプロイできません。たとえば、次のような情報があります。
-
ポータルのコンテンツ・フォルダの外部に格納されたポータル・アセット、コンテンツ・プレゼンタまたはSite Studioで使用されるコンテンツ
-
ポータル・ディスカッション
-
ポータル・メール
-
ポータル分析
-
ページレット・プロデューサのリソース
注意:
接続は、個別にエクスポートおよびインポートされます。詳細は、「接続プロパティ・ファイルの理解」を参照してください。
図33-1に、ポータル(およびその関連データ)を別のサーバーに移動できる様々な方法を示します。
ソースWebCenter PortalインストールとターゲットWebCenter Portalインストールが異なる外部サーバーに接続されている状況で、ソース・ポータルに関連付けられた情報がターゲットで必要になる場合、外部ポータル・データを個別に移動する必要があります。
注意:
ポータルのエクスポートまたはデプロイ中に、サーバーが停止してクラスタ内の他のサーバーにフェイルオーバーすると、操作が失敗します。ページをリフレッシュして、エクスポートまたはデプロイメント操作を再度実行する必要があります。50MBを超えるポータルをデプロイする場合は、要件に応じて、ターゲット・サーバー上の最大ファイル・アップロード・サイズを変更してください。詳細は、「コンテンツ・マネージャでのファイル・アップロード・サイズの変更」を参照してください。
ポータルのデプロイメントの問題のトラブルシューティングの詳細は、「WebCenter Portalのトラブルシューティング」を参照してください。
WebCenter Portalを使用したポータルの直接デプロイ
WebCenter Portal管理を使用して、最初に、ターゲット・サーバーへの接続を作成し、次に、ポータルをターゲット・サーバーに直接デプロイします。ポータルがデプロイされた後、そのデプロイメント・ステータスとデプロイメント履歴を表示できます。
この項には次のトピックが含まれます:
ポータル・サーバー接続の作成
ポータルをデプロイする前に、ターゲット・ポータル・サーバーへの接続を設定する必要があります。
ポータル・サーバー接続を作成する手順は次のとおりです。
-
WebCenter Portalにログオンして、ポータル管理に移動します。
-
「ツールとサービス」をクリックします。
-
ツールとサービスのリストから、「ポータル・サーバー接続」を選択します。
-
「作成」をクリックします。
-
「ポータル・サーバー接続の作成」ページで、次の詳細情報を指定します。
-
名前: 接続の名前を指定します。使用できるのは英数字のみであることに注意してください。
-
URL: ターゲット・ポータル・サーバーのURLを次の形式で指定します。
http://
targetserverhost:port
ここで、
targetserverhost:port
は、ポータルをデプロイするポータル・サーバーのホスト名およびポート番号です。 -
ユーザー名: ターゲット・サーバーへの接続に使用するユーザー名を入力します。
-
パスワード: 指定したユーザー名のパスワードを入力します。
-
-
「テスト」をクリックして、接続が機能することを確認します。
-
「作成」をクリックします。
ポータル・サーバーがオフラインであることが原因で接続テストに失敗した場合は、接続が設定され、サーバーが利用可能になると使用できることに注意してください。
WebCenter Portalを使用したポータルのデプロイ
注意:
ポータルのデプロイは主にシステム管理者のタスクですが、Portal Server: Deploy
権限を他のカスタム・ロールに割り当てることができます。ポータルをデプロイできるユーザー・ロールを制限するために、カスタム・ロールを作成して、この権限をカスタム・ロールに割り当てることをお薦めします。
ポータルのポータル・マネージャ(または委任マネージャ)のみがポータルをデプロイでき、これに加えて、Portal Server: Deploy
権限を持つロールも必要です。
カスタム・アプリケーション・ロールの作成とロールへのユーザーの追加の詳細は、「アプリケーション・ロールの定義」および「アプリケーション・ロールへのユーザー(およびグループ)の割当て」を参照してください。
WebCenter Portalを使用してポータルをデプロイする手順は次のとおりです。
WLSTを使用したポータルの直接デプロイ
WLSTコマンドdeployWebCenterPortal
を使用して、単一のオンライン・ポータルを別のターゲット・サーバーに直接デプロイできます。WLSTを使用してソースのポータルの変更をターゲットに伝播する場合は、deployWebCenterPortal
を使用してポータルをデプロイする必要があります。
ポータルをデプロイする前に、いくつかの前提条件タスクを完了する必要があります。全体のプロセスは次のようになります。
ポータル・アーカイブのデプロイ
管理者は、WebCenter PortalまたはWLSTコマンドを使用して、ポータル・アーカイブ(.par
ファイル)を任意のWebCenter Portalインストールにデプロイできます。ターゲット・ポータル・サーバーは、1つ以上のポータルをファイルからデプロイ(またはインポート)するときに稼働している必要があります。
この項には次のトピックが含まれます:
注意:
ポータルをアーカイブから別のサーバーにデプロイする場合、ポータル伝播を使用して後からポータルに増分更新を行うことはできません。ポータル伝播機能は、ポータルの直接デプロイメントで使用する場合のみ可能です。「本番でのポータルの伝播および再デプロイ」を参照してください。
ポータル・アーカイブの理解
単一ポータルのポータル・アーカイブ(.par
ファイル)を作成することも、同じ.par
ファイルに複数のポータルをアーカイブすることもできます。
ポータル・アーカイブには、次の内容を含めることができます。
-
1つ以上のポータル・データ・アーカイブ
(.pdr
)ファイル: ポータル・アーカイブには、アーカイブに追加した各ポータルのPDRが含まれます。PDRには、ポータルのセキュリティ・ポリシーと、ポータルのメタデータ、データおよびコンテンツを取得するメタデータ・アーカイブが含まれます。 -
エクスポート・ログ・ファイル(
.log
): エクスポート・ログ・ファイルには、すべてのポータル、MDSメタデータ・ファイル、およびアーカイブに含まれるデータ(ポータル・データを含むデータベース表の名前)がリスト表示されます。 -
connections.xmlファイル: 詳細は、「接続プロパティ・ファイルの理解」を参照してください。
-
WebCenter Portalの接続プロパティ・ファイル(
connection.properties
)
注意:
ポータル・アーカイブ(.par
ファイル)は、WLSTコマンドlistWebCenterPortalArchive
を使用して抽出できます。
接続プロパティ・ファイルの理解
接続の全部または一部が存在しないWebCenter Portalターゲットでポータルのインポート、デプロイ、伝播またはリストアを行う予定の場合、WLSTコマンドexportWebCenterPortalConnections
を使用して、ソース環境からconnection.properties
ファイルを生成し、WLSTコマンドimportWebCenterPortalConnections
を使用して、そのファイルで構成済の存在しない接続をターゲット環境にインポートすることをお薦めします。詳しい手順は、「ファイルからの新しいWebCenter Portal接続のインポート」を参照してください。
注意:
-
connection.properties
ファイルは、WLSTコマンドexportWebCenterPortalConnections
を実行するときにも生成されます。詳細は、「ファイルへのWebCenter Portal接続の詳細のエクスポート」を参照してください。 -
ソースWebCenter Portal環境で構成されるすべての接続は、
connection.properties
にエクスポートされます。このファイルの接続情報は、アーカイブのポータルに固有ではありません。 -
ターゲットには、新しい接続のみがインポートされます。ターゲット上に存在する接続は無視されます。
接続の詳細の変更
サーバー名やポートなどの一部の接続情報がソース環境とターゲット環境で異なる場合、ポータルのインポート、デプロイ、伝播またはリストアを行う前に、ファイルの接続の詳細を分けて変更することができます。
表33-1に、ソースとターゲットで同じホストを使用しないために別のURLパラメータがターゲットで必要な場合の例を示します。
表33-1 例: ソース環境とターゲット環境で接続URLが異なる場合
接続タイプ | ソース接続: URLパラメータ | ターゲット接続: URLパラメータ |
---|---|---|
WSRPポートレット・プロデューサ |
http://mysource.com:8899/MyWSRPPortletProducer/portlets/wsrp2?WSDL |
http://mytarget.com:8899/MyWSRPPortletProducer/portlets/wsrp2?WSDL |
PDK-Javaプロデューサ |
http://source.host.com:7778/myJPDKPortletProducer/providers |
http://target.host.com:7778/myJPDKPortletProducer/providers |
Webサービス |
http://source.example.com/getEmployee?empId=20+deptId=10 |
http://target.example.com/getEmployee?empId=20+deptId=10 |
図33-9に、新しい接続がターゲットに作成される前にソース・パラメータとターゲット・パラメータが変わる場合、接続の詳細をconnection.properties
で編集する方法を示します。
接続タイプと接続プロパティ
表33-2に、connection.properties
ファイルで取得されるすべての接続と、各種接続タイプでエクスポートされるプロパティを示します。この表には、デプロイメント前に編集できるプロパティと、ターゲットで設定する必要があるプロパティも示されています。
注意:
-
特定の接続タイプに対する必須のプロパティまたはオプションのプロパティなど、個々の接続プロパティの詳細は、該当の接続タイプの章を参照してください。章のリストは、「ツールとサービスの管理」を参照してください。
-
表33-2でデプロイメント時に編集しますか。がはいとなっているプロパティのみを
connection.properties
で編集することを強くお薦めします。なんらかの理由でデプロイメント時に編集しますか?がいいえのプロパティを編集する必要がある場合は、Fusion Middleware ControlまたはWLSTコマンドを使用してターゲットに接続を移行した後に編集できます。
表33-2 connection.propertiesにエクスポートされる接続プロパティ
接続タイプ | エクスポートされるプロパティ | デプロイメント時に編集しますか。 | 注意およびデプロイメント後の構成要件 |
---|---|---|---|
WSRPポートレット・プロデューサ |
|
|
デプロイメント後のセキュリティ構成:
|
PDK-Javaプロデューサ |
|
|
デプロイメント後のセキュリティ構成:
|
Webサービス接続 |
|
|
Webサービス接続は、データ・コントロールで使用されます。 |
URL接続: HTTP URL |
|
|
デプロイメント後のセキュリティ構成:
|
URL接続: ファイルURL |
|
|
|
ページレット・プロデューサ |
|
|
|
分析コレクタ |
|
|
|
BPELサーバー |
|
|
|
ディスカッション・サーバー |
|
|
|
外部アプリケーション |
|
|
パブリック資格証明または共有資格証明をソースで構成する場合、その資格証明はセキュリティ上の理由でエクスポートされません。これらの資格証明は、必要に応じてデプロイメント後にターゲットで構成する必要があります。 |
プレゼンス・サーバー: Microsoft Lync 2010 |
|
|
|
メール・サーバー |
|
|
デプロイメント後のLDAP構成:
|
個人イベント・サーバー |
|
|
|
Oracle SES |
|
|
|
WebCenter Content Server (ソケット) |
|
|
デプロイメント後のセキュリティ構成:
|
WebCenter Content Server (socketssl) |
|
|
デプロイメント後のセキュリティ構成:
|
WebCenter Content Server (jaxws) |
|
|
デプロイメント後のセキュリティ構成:
|
WebCenter Content Server (Web) |
|
|
デプロイメント後のセキュリティ構成:
|
ファイル・システム |
|
|
|
ワークリスト接続 |
|
|
|
REST接続 |
|
|
脚注1
セキュリティ関連の構成: 接続にはポリシー情報のみが含まれます。セキュリティ・ポリシーに設定されたオーバーライドは含まれないため、デプロイメント後にこれらのパラメータを構成する必要があります。
接続情報を別のサーバーにデプロイする方法を確認するには、「ステージングから本番への接続の詳細の移動」を参照してください。
アーカイブの保護
この項には次のトピックが含まれます:
アーカイブ・ファイルの保護について
WebCenter Portalは、ポータル・アーカイブをエクスポートまたはインポートするときに実行される検証チェックをサポートします。これにより、破損したファイルや任意のファイルがポータル・サーバーに含まれることが防止され、ポータル・アーカイブが保護されます。
ライフ・サイクル操作に対して、次のいずれかのセキュリティ・レベルを設定することを選択できます。
-
高セキュリティ・モード: 資格証明を格納する外部アプリケーションに対してマップされた
ExternallySecureLifecycleOperations
カスタム属性を設定し、チェックサム値を格納するファイルを暗号化または復号化します。 -
中程度のセキュリティ・モード: 値
enable
に対してマップされたSecureLifecycleOperations
カスタム属性を設定します。値をenable
に設定するか、空白のままにすると、ライフ・サイクル操作はデフォルトの非セキュア・モードで実行されます。値をenable
に設定すると、ライフ・サイクル操作が保護され、チェックサムが暗号化または復号化プロセスに対する資格証明として機能します。 -
非セキュア・モード: デフォルトでは、アーカイブに対するセキュリティ制限なしでライフ・サイクル操作が実行されます。
エクスポート操作中に、チェックサムが計算されて、すべてのライフ・サイクル・アーカイブ(ポータル・アーカイブ、アプリケーション・アーカイブおよびアセット・アーカイブ)に追加されます。チェックサムは、.par
または.aar
ファイル内のlifecycle.chk
というファイルに格納され、ファイルが暗号化されます。アーカイブのインポート中に、ファイルが復号化されてチェックサム値がフェッチされます。中程度のセキュリティ・モードでは、(内部で計算された)チェックサムが、ファイルを暗号化または復号化するためのパスワードとして機能します。高セキュリティ・モードでは、共有資格証明を持つ外部アプリケーションがパスワードとして使用され、パスワードをフェッチするためにExternallySecureLifecycleOperations
カスタム属性が使用されます。
ライフ・サイクル操作のセキュア・モードを構成するときは、次のことを考慮してください。
-
保護されたソース環境でアーカイブがエクスポートされて、ターゲット環境が保護されていない場合は、アーカイブでセキュリティ検証が実行されません。
-
ライフ・サイクル操作が保護されており、アーカイブのインポート中にアーカイブに
lifecycle.chk
ファイルがない場合、セキュリティ違反となり、インポート操作が許可されません。 -
ライフ・サイクル操作を保護する必要がある場合は、ターゲットとソースのインスタンスで同じセキュリティ・レベルを設定する必要があります。異なるレベルのセキュリティ・モードはサポートされません。
-
高セキュリティ・モードが設定されている場合、暗号化と復号化が機能するには、ソースとターゲットの両方のインスタンスで同じパスワードを使用する必要があります。
ポータル・アーカイブのエクスポートおよびインポート
ターゲット・サーバーへの直接接続が存在しない場合、最初にポータルをアーカイブ(.par
ファイル)にエクスポートしてから、アーカイブをターゲット・サーバーにインポートして、ポータルをデプロイできます。また、ポータルのバックアップを作成して、後で同じインスタンスにリストアする場合にも、ポータル・アーカイブを作成できます。
注意:
ポータルをアーカイブから別のサーバーにデプロイする場合、ポータル伝播を使用して後からポータルに増分更新を行うことはできません。ポータル伝播機能は、ポータルの直接デプロイメントで使用する場合のみ可能です。「本番でのポータルの伝播および再デプロイ」を参照してください。
ポータル・アーカイブをエクスポートしてからインポートするには:
アーカイブへのポータルのエクスポート
WebCenter Portalで実行するポータルのアーカイブ(.par
ファイル)を生成できます。ポータル・アーカイブは、WebCenter Portal、exportWebCenterPortals
のWLSTコマンドまたはREST APIを使用して作成できます。
ポータル・アーカイブの作成方法を確認するには、次の項を参照してください。
ポータルのエクスポートの前提条件
ポータルをアーカイブ(.par
ファイル)にエクスポートする前に、次の事項を確認します。
-
Content Serverに格納されるポータル・コンテンツ: Content Serverに格納されるポータル・コンテンツをポータル・アーカイブに含める場合、Content Serverが稼働していることを確認します。ポータル・アーカイブにはセキュリティ設定が組み込まれていません。インポート時にターゲット・ポータル・サーバーのセキュリティ・グループが適用されます。
-
Webサービス・データ・コントロール: エクスポートするポータルにWebサービス・データ・コントロールが含まれる場合、エクスポートが正常に行われるには、関連するすべてのWebサービスが稼働中でアクセス可能である必要があります。
-
ポートレット・プロデューサ: エクスポートするポータルにポートレットが含まれる場合、すべてのポートレット・メタデータがアーカイブに含まれるようにするには、関連するすべてのポートレット・プロデューサが稼働中でアクセス可能である必要があります。
-
ポータル・フォルダ外部のコンテンツ: ポータル・アセット、ポータル・ページ、コンテンツ・プレゼンタおよびSite Studioで使用される、ポータル・フォルダの外部に格納されているコンテンツ(ファイル、イメージおよびアイコンなど)は、アーカイブに自動的に含まれません。すべての依存ファイルを、ターゲット・コンテンツ・サーバーの適切な場所にコピーする必要があります。
注意:
MDSにアーティファクトを格納するレガジー・ポータル(アセットを含む)を管理する場合、MDSのすべての依存アーティファクトをコンテンツ・サーバーに再配置することをお薦めします。MDSに格納されているアーティファクトを移動しない場合、MDSのWLSTコマンド
exportMetadata
/importMetadata
を使用して、MDSのコンテンツを別のターゲットに移動できます。例:exportMetadata(application='webcenter', server='
WC_Portal
', toLocation='/tmp/content', docs='/oracle/webcenter/siteresources/scopedMD/shared/**') importMetadata(application='webcenter', server='WC_Portal
', fromLocation='/tmp/content', docs='/oracle/webcenter/siteresources/scopedMD/shared/**')
WebCenter Portal管理を使用したオンライン・ポータルのアーカイブへのエクスポート
Portal Server-Manage All
権限またはManage Configuration
権限により、WebCenter Portal管理を使用してポータルをアーカイブにエクスポートして、ローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムにポータル・アーカイブを保存できます。
注意:
ポータル・テンプレートもエクスポートできますが、別のプロセスになります。ポータルとポータル・テンプレートを1つのアーカイブ内にエクスポートすることはできません。
1つ以上のポータルをエクスポートするには:
WLSTを使用したオンライン・ポータルのアーカイブへのエクスポート
WLSTコマンドexportWebCenterPortals
を使用して、1つ以上のポータルをポータル・アーカイブ(.par
ファイル)にエクスポートします。WLSTを使用してポータル・アーカイブを作成する場合、ポータルのコンテンツ・フォルダと接続情報をアーカイブに含めるかどうかを選択できます。
exportWebCenterPortals(appName, fileName, [names, offlineDuringExport, exportPortalContent, exportConnections, exportSharedAssets, server, applicationVersion])
設定するオプションは、特定のアーカイブ要件によって異なります。コマンドの構文の詳細は、『WebCenter WLSTコマンド・リファレンス』のexportWebCenterPortals
に関する項を参照してください。
WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。
次に例を示します。
例1: 2つのポータルのエクスポート
この例では、Sales
およびFinance
という2つのポータルと、すべてのコンテンツ、データ、セキュリティ、カスタマイズおよび接続情報をエクスポートします。
exportWebCenterPortals(appName='webcenter', fileName='MyPortalExport.par', names='Sales,Finance', exportPortalContent=1, exportConnections=1)
例2: コンテンツ・フォルダまたは接続の詳細を含めない単一オフライン・ポータルのエクスポート
この例では、MySales
をオフラインにして、ポータルをMyPortalExport.par
にエクスポートします。
exportWebCenterPortals(appName='webcenter', fileName='MyPortalExport.par', names='Sales', offlineDuringExport=1)
REST APIを使用したポータルのエクスポート
REST APIサポートを使用して、ポータルのポータル・アーカイブ(.par
ファイル)を生成できます。
REST APIを使用してポータルをエクスポートするには、次の形式のURLを使用します。
http://host:port
/rest/api/v1/portal/portals/portal_shortId
/archive?utoken=utoken_value
ここで、host
: port
はポータルが実行されているサーバーのホスト名とポート番号で、portal_shortId
はエクスポートされるポータルのショートIDです。
ポータル・コンテンツもエクスポートする場合は、次のようにincludePortalContentValue
パラメータをURLに含めます。
http://host:port/rest/api/v1/portal/portals/portal_shortId/archive?includePortalContent=includePortalContentValue&utoken=utoken_value
includePortalContent
のデフォルト値は0です。0より大きい値はtrueとして処理され、ポータル・コンテンツがポータル・アーカイブに含められます。
ポータルをエクスポートするには、wpfas/modules/rest-service/servlet/src/java/oracle/webcenter/jaxrs/services/portal/controller/PortalsResource.java
で、次の形式のGET操作を追加します。
@GET @Path("{portalId}/archive") public Response exportPortal(@PathParam("portalId") String portalId, @DefaultValue(START_INDEX_DEFAULT) @QueryParam("includePortalContent") int includePortalContent);
GET操作により、ポータルのエクスポートを実行するAPIがコールされます。その後、PARファイルをローカル・クライアントにダウンロードできます。レスポンス・コード200は、ポータルのエクスポートが成功したことを表します。
アーカイブからのポータルのインポート
管理者は、アーカイブ・ポータル(.par
ファイル)を任意のWebCenter Portal Serverにデプロイできます。WLSTコマンドimportWebCenterPortals
を使用してポータル・アーカイブをインポートするか、WebCenter Portal管理を使用できます。
インポートの際、アーカイブに含まれるすべてのポータルは、ターゲット・サーバーで作成または再作成されます。既存のポータルは、削除されてから置き換えられ、新しいポータルが作成されます。ターゲット・サーバーで使用可能なポータルと同じ名前のポータルをインポートする場合、オンラインのポータルは上書きできないため、それらのポータルがターゲット・アプリケーションでオフラインになっていることを確認します。詳細は、「任意のポータルのオフライン化」を参照してください。
注意:
WLSTを使用してポータルをインポートする場合、オプションforceOffline=1
を設定して、オンライン・ポータルが自動的にオフラインになるようにすることができます。この方法でオフライン化されたポータルは、インポート・プロセス終了時はオフラインのままです。
ポータルは、同じポータルの同時インポートまたはエクスポートを回避するために、インポート操作中にロックされます。他のユーザーが特定のポータルをインポートする場合、同じポータルをインポート(またはエクスポート)しようとするすべての後続の試みはブロックされます。
1つ以上のポータルをインポートした後で、Oracle Secure Enterprise Searchクロールを開始して、新たにインポートされたデータを索引付けすることを検討してください。
ポータル・アーカイブ・コンテンツ(インポート時のオプション)
ポータル・アーカイブにポータルのコンテンツ・フォルダが含まれる場合があります。含まれる場合、この情報をインポートするかどうかも選択できます。インポート時に、アーカイブのコンテンツ・フォルダでターゲットのフォルダ(存在する場合)が上書きされ、ターゲット・ポータル・サーバーのセキュリティ・グループが適用されます。
注意:
コンテンツ・プレゼンタで表示されるWebコンテンツやページはポータルのコンテンツ・フォルダに格納されないため、ポータル・アーカイブには含まれません。
外部ポータル・データ(個別インポート)
ディスカッションなど、外部に格納されるデータはポータルごとに移行できますが、これは個別プロセスになります。「ポータルのディスカッションとページレット・プロデューサのリソースの移行」を参照してください。
ポータル・アーカイブのインポート方法を確認するには、次の項を参照してください。
ポータルのインポートの前提条件
ポータル・アーカイブ(.par
ファイル)をインポートする前に、次の事項を確認します。
-
共有アイデンティティ・ストア: ソース環境とターゲット環境のユーザーが同じであることを確認します。共有アイデンティティ・ストアを使用しない場合、システム管理者は、ユーザーをターゲットに移行する必要があります。「WebCenter Portalスキーマ・データのバックアップ(エクスポート)」および「WebCenter Portalデータのリストア(インポート)」を参照してください。
-
ターゲットに存在するポータル: アーカイブのポータルがターゲットにすでに存在するかどうかを確認します。必要な場合、「任意のポータルのオフライン化」の説明に従って、インポート・プロセスで既存のポータルをオフライン化します。
-
Webサービス・データ・コントロール: インポートするポータルにWebサービス・データ・コントロールが含まれる場合、インポートが正常に行われるには、関連するすべてのWebサービスが稼働中でアクセス可能である必要があります。
-
ポートレット・プロデューサ: ポータルで使用されるポートレット・プロデューサが、ポータルのインポート時に稼働している必要があります。
-
外部サーバー、アプリケーション、Webサービスおよびポートレット・プロデューサへの接続: 特定の外部接続の構成に依存するポータルは、同様の接続がターゲットに存在しない場合は機能しません。ポータルをインポートする前に、必要なすべての接続がターゲットに存在することを確認します。ターゲットで接続を作成または再構成する場合、ターゲットの管理対象サーバーの再起動が必要になる場合があります。詳細は、「ステージングから本番への接続の詳細の移動」を参照してください。
-
アーカイブ・バージョン: WebCenter Portal 11gリリースからポータル・アーカイブをインポートする場合、まず最新リリースのWebCenter Portal 12cにアップグレードし、ポータル・エクスポート・アーカイブ(.parファイル)を再作成してから、それをインポートします。
アップグレードについては、『Oracle WebCenterのアップグレード』のOracle WebCenterのアップグレード・プロセス・フローの理解に関する項を参照してください。
WebCenter Portal管理を使用したポータルのアーカイブからのインポート
Portal Server-Manage All
権限またはManage Configuration
権限がある場合、WebCenter Portal管理を使用してポータルをポータル・アーカイブからインポートできます。
1つ以上のポータルを.par
ファイルからインポートするには:
通常、新しいポータルを使用できるようにするには、ある程度の追加作業が必要です。そのため、新しくインポートされたすべてのポータルは、最初はオフラインになっています。たとえば、次のような操作を一時的に行う場合があります。
-
バックエンド・コンポーネントに関連付けられたデータの移行。
詳細は、「ポータルのディスカッションとページレット・プロデューサのリソースの移行」を参照してください。
-
メンバーの追加や招待。
-
ツールとサービスの有効化または無効化。
ポータル・コンテンツとメンバーシップの詳細が確定したら、ポータルをオンラインにできます。「任意のポータルの再オンライン化」を参照してください。
WLSTを使用したポータルのアーカイブからのインポート
WLSTコマンドimportWebCenterPortals
を使用して、1つ以上のアーカイブ・ポータルをWebCenter Portalにインポートします。
importWebCenterPortals(appName, fileName, [names, parentPortal, importCustomizations, importPortalContent, importSecurity, importData, importActivities, overwrite, savePortals, forceOffline, importLog, importConnections, connPropertiesFile, importSharedAssets, server, applicationVersion])
WLSTを使用してポータルをインポートする場合、アーカイブ内のすべての内容をインポートする必要はありません。アーカイブに複数のポータルが含まれる場合、インポートするポータルのみを指定できます。ポータルとともにどの程度の情報をインポートするかも指定できます。たとえば、ポータルのコンテンツ・フォルダまたは共有アセットをインポートするかどうかを選択できます。これらのオプションは、テスト環境から、テスト関連のデータやコンテンツが必ずしも必要ではないステージング環境または本番環境にポータルを移動する場合などに役立ちます。
設定するオプションは、特定の要件によって異なります。コマンドの構文の詳細は、『WebCenter WLSTコマンド・リファレンス』のimportWebCenterPortals
に関する項を参照してください。
WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。
次に例を示します。
例1: ターゲットに2つのポータルを初めてインポートする場合
この例では、Sales
およびFinance
という2つのポータルと、すべてのコンテンツおよびセキュリティをインポートして、インポート・ログ・ファイルの名前と場所も指定します。
importWebCenterPortals(appName='webcenter', fileName='MyPortalExport.par', names='Sales,Finance', importLog='/myimportlogs/myPortal_import.log')
例2: ターゲットに存在するポータルをインポートする場合
この例では、ターゲットでmyExistingPortal
というポータルをバックアップして、ターゲット・ポータルをアーカイブ・バージョン(可能性のあるすべてのデータを除外)で上書きします。
importWebCenterPortals(appName='webcenter', fileName='MyPortalExport.par', names='myExistingPortal', importPortalContent=0, importActivities=0, overwrite=1, savePortals=1)
REST APIを使用したポータルのインポート
REST APIを使用して、ポータルをWebCenter Portalにインポートできます。
REST APIを使用してポータルをインポートするには、次の形式のURLを使用します。
http://host:port
/rest/api/v1/portal/portals?utoken=<utoken_value>
ここで、host
:port
はポータルをインポートするサーバーのホスト名およびポート番号です。
ポータルをインポートするには、wpfas/modules/rest-service/servlet/src/java/oracle/webcenter/jaxrs/services/portal/controller/PortalsResource.java
で、次の形式のPOST操作を追加します。
@POST @Consumes({MediaType.MULTIPART_FORM_DATA, MediaType.APPLICATION_OCTET_STREAM}) @ResourceType("urn:oracle:webcenter:portal:portals") public Response importPortal(MultiPart multiPartData, @DefaultValue(START_INDEX_DEFAULT) @QueryParam("includePortalContent") int includePortalContent);
POST操作を使用してポータルのインポートを実行するには、コンテンツ・タイプがmultipart/form-data
として指定されている必要があります。マルチパート形式では、各パートはオブジェクトのデータの連続する部分です。各オブジェクトのパートは、個別に任意の順序でアップロードできます。いずれかのパートの送信が失敗した場合は、他のパートに影響を与えることなくそのパートを再送信できます。また、POST操作では、fileName
キーにマップされるポータル・アーカイブのファイル名も必要です。
ポータル・アーカイブの表示および抽出
WLSTコマンドlistWebCenterPortalArchive
を使用して、ポータル・アーカイブ(.par
ファイル)のコンテンツを表示します。必要に応じて、ポータル・アーカイブのコンテンツを、選択した場所に抽出することもできます。コマンドの構文の詳細は、『WebLogic Server WLSTコマンド・リファレンス』のlistWebCenterPortalArchive
に関する項を参照してください。
WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。
ポータル・テンプレートのデプロイ
管理者は、ポータル・テンプレートをWebCenter Portalからエクスポートして、そのテンプレートを別のポータル・サーバーにデプロイできます。デフォルトのテンプレートはエクスポートできません。
エクスポートおよびインポート・ユーティリティは、WebCenter Portalインスタンス間での情報の移動に主に使用されますが、ポータル・テンプレートのエクスポート機能は、バックアップ・サービスとしても役立ち、他のユーザーとのテンプレートの共有と交換にも便利です。
ポータル・テンプレートには、ページ、ドキュメント、ポータル・アセットおよびセキュリティ情報(カスタム・ロールやメンバーの詳細など)を含めることができます。すべてのテンプレート・データがポータル・テンプレート・アーカイブに含まれる場合、ポータル・テンプレートを別のWebCenter Portal Serverにデプロイする際にテンプレート・データをターゲットに手動で移行する必要はありません。
ドキュメント・サービス(ファイル、フォルダ、Wiki、ブログ)を使用するポータル・テンプレートは、WebCenter Portalのバックエンド・コンテンツ・リポジトリにコンテンツ・フォルダを自動的に持ちます。WebCenter Portal管理を使用してポータル・テンプレートをエクスポートする場合、このフォルダに格納されるコンテンツは、自動的にポータル・テンプレート・アーカイブに含まれるため、別のターゲット・サーバーへのデプロイメントが容易になります。
WLSTコマンドexportWebCenterPortalTemplates
を使用してポータル・テンプレートをエクスポートする場合、コンテンツ・フォルダはオプションになります。
注意:
ポータル・テンプレート・アーカイブには、ポータル・テンプレートで参照されるWebコンテンツやページ(他の場所に格納される)は含まれません。たとえば、コンテンツ・プレゼンタで表示される情報(ポータル・テンプレートのコンテンツ・フォルダに格納されない)などがあります。WebCenter Portalのバックエンド・コンテンツ・リポジトリでポータル・テンプレートに割り当てられたフォルダのみが、ポータル・テンプレート・アーカイブに含まれます。
この項には次のトピックが含まれます:
ポータル・テンプレートのエクスポート
管理者は、WLSTコマンドexportWebCenterPortalTemplates
を使用して、1つ以上のポータル・テンプレートをアーカイブにエクスポートできます。あるいは、管理者とアプリケーション・スペシャリストは、WebCenter Portal管理を使用して、ポータル・テンプレートをアーカイブにエクスポートできます。
この項には次のトピックが含まれます:
WebCenter Portalを使用したポータル・テンプレートのアーカイブへのエクスポート
アプリケーション・スペシャリスト(およびPortal Templates: Manage All
権限を持つその他のユーザー)は、WebCenter Portalからポータル・テンプレートをエクスポートできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・テンプレートのエクスポートに関する項を参照してください。
注意:
ポータルとポータル・テンプレートを1つのアーカイブ内にエクスポートすることはできません。ポータルのエクスポートは個別のプロセスになります。詳細は、「WebCenter Portal管理を使用したオンライン・ポータルのアーカイブへのエクスポート」を参照してください。
WLSTを使用したポータル・テンプレートのアーカイブへのエクスポート
WLSTコマンドexportWebCenterPortalTemplates
を使用して、1つ以上のポータル・テンプレートをアーカイブ(.par
ファイル)にエクスポートします。WLSTを使用してポータル・テンプレート・アーカイブを作成する場合、ポータルのコンテンツ・フォルダをアーカイブに含めるかどうかを選択できます。
exportWebCenterPortalTemplates(appName, fileName, [names, exportPortalTemplateContent, exportConnections, server, applicationVersion])
設定するオプションは、特定のアーカイブ要件によって異なります。コマンドの構文の詳細は、『WebCenter WLSTコマンド・リファレンス』のexportWebCenterPortalTemplates
に関する項を参照してください。
WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。
次に例を示します。
例1: 2つのポータル・テンプレートのエクスポート
この例では、SalesTargetTemplate
およびNewProjectTemplate
という2つのテンプレートと、その関連コンテンツ・フォルダをエクスポートします。
exportWebCenterPortalTemplates(appName='webcenter', fileName='MyTemplateExport.par', names='SalesTargetTemplate,NewProjectTemplate', exportPortalTemplateContent=1)
例2: コンテンツ・フォルダを含まない単一ポータル・テンプレートのエクスポート
この例では、New Hire
テンプレートをエクスポートします。ドキュメントはこのテンプレートで有効ではないため、テンプレートにコンテンツ・フォルダはありません。
exportWebCenterPortals(appName='webcenter', fileName='MyTemplateExport.par', names='NewHire')
ポータル・テンプレートのインポート
管理者は、WLSTコマンドimportWebCenterPortals
を使用して、1つ以上のポータル・テンプレートをWebCenter Portal Serverにデプロイできます。あるいは、管理者とアプリケーション・スペシャリストは、WebCenter Portal管理を使用して、ポータル・テンプレートをアーカイブからインポートできます。
インポート時に、アーカイブに含まれるすべてのポータル・テンプレートがターゲット・アプリケーションで再作成されます。ターゲットにポータル・テンプレートが存在する場合は、削除されて置き換えられます。ポータル・テンプレートが存在しない場合は作成されます。
新たにインポートされたポータル・テンプレートは、すぐには使用できません。すべてのユーザーが使用できるようにするには、新たにインポートされたテンプレートを公開する必要があります。『Oracle WebCenter Portalでのポータルの構築』のポータル・テンプレートの公開または非表示に関する項を参照してください。
この項には次のトピックが含まれます:
WebCenter Portalを使用したポータル・テンプレートのアーカイブからのインポート
アプリケーション・スペシャリスト(およびPortal Templates: Manage All
権限を持つその他のユーザー)は、WebCenter Portalにポータル・テンプレートをインポートできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・テンプレートのインポートに関する項を参照してください。
WLSTを使用したポータル・テンプレートのアーカイブからのインポート
WLSTコマンドimportWebCenterPortals
を使用して、1つ以上のポータル・テンプレートをアーカイブ(.par
ファイル)からインポートします。WLSTを使用してポータル・テンプレート・アーカイブをインポートする場合、テンプレートのコンテンツ・フォルダをインポートするかどうかを選択できます。
importWebCenterPortals(appName, fileName, [names], [parentPortal], [importCustomizations], [importPortalContent], [importSecurity], [importData], [importActivities], [overwrite], [savePortals], [forceOffline], [importLog], ]importConnections], [connPropertiesFile], [importSharedAssets], [server], [applicationVersion])
設定するオプションは、特定のアーカイブ要件によって異なります。コマンドの構文の詳細は、『WebCenter WLSTコマンド・リファレンス』のimportWebCenterPortalsに関する項を参照してください。
WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。
次に例を示します。
例1: コンテンツを含まない新しいポータル・テンプレートのインポート
次の例では、myPortalTemplateExport.par
にアーカイブされているポータル・テンプレートNew Hire
をインポートして、インポート・ログ・ファイルの名前と場所を指定します。ドキュメントはこのテンプレートで有効ではないため、テンプレートにコンテンツ・フォルダはありません。
importWebCenterPortals(appName='webcenter', fileName='myPortalTemplateExport.par', names='NewHire', importLog='newHireTemplate_import.log')
例2: コンテンツを含む2つの既存のポータル・テンプレートのインポート
この例では、SalesTargetTemplate
およびNewProjectTemplate
というポータル・テンプレートをターゲットでバックアップして、既存のテンプレートとそのコンテンツ・フォルダを、myPortalTemplateExport.par
の情報で上書きします。
importWebCenterPortals(appName='webcenter', fileName='myPortalTemplateExport.par', names='SalesTargetTemplate,NewProjectTemplate', importPortalContent=1, overwrite=1, savePortals=1, importLog='myPortalTemplate_import.log')
アセットのデプロイ
認可されたユーザーは、WebCenter Portalの実行時に、スキンおよびページ・テンプレートなどのアセットをダウンロードし、Oracle JDeveloperなどのツールでそれらのアセットを編集および拡張してから、WebCenter Portalにデプロイしなおすことができます。アセットを他のWebCenter Portalインスタンスと共有するユーザーやWebCenter Portalインスタンスに移行するユーザーも、ダウンロード機能とアップロード機能を使用できます。
WebCenter Portalユーザーは、WebCenter Portalを使用して次のアセットをダウンロードおよびアップロードでき、管理者は、WLSTコマンドを使用して同じタスクを実行できます。
-
ページ・テンプレート
-
リソース・カタログ
-
スキン
-
ページ・スタイル
-
コンテンツ・プレゼンタ表示テンプレート
-
可視化
-
ページレット
-
ビジネス・オブジェクト
-
タスク・フロー・スタイル
-
タスク・フロー
-
レイアウト
-
データ・コントロール
-
データ・ソース
注意:
個々のページレットのアップロードまたはダウンロードはできませんが、個々のポータルやWebCenter Portalインスタンス全体を移行するときにすべてのアセット(ページレットを含む)が含まれます。
WebCenter Portalのアセットをダウンロード(またはエクスポート)する場合、アセットの詳細はエクスポート・アーカイブ(.aar
ファイル)に保存されます。希望のファイル名を使用して、エクスポート・アーカイブをローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムに保存することができます。アセットによって使用または参照されるアイコンやイメージなどのアーティファクトは、それらがContent Serverのポータルのコンテンツ・フォルダに格納されてコンテンツ・フォルダがソース・サーバーとターゲット・サーバーで同期している場合を除いて、エクスポート・アーカイブまたはインポート・アーカイブに含まれません。
デバイスおよびデバイス・グループ
.aar
ファイル)にエクスポートし、これらを別のWebCenter Portalインスタンスにインポート(デプロイ)できます。たとえば、ステージングで開発されたデバイスまたはデバイス・グループを本番サーバーに移動する場合や、デバイスおよびデバイス・グループを別のWebCenter Portalインストールと共有する場合などがあります。
注意:
デフォルトのデバイス・グループやデバイスをエクスポートまたはインポートすることはできません。自分や他の管理者が作成またはコピーしたデバイス・グループやデバイスのみをエクスポートおよびインポートできます。
この項には次のトピックが含まれます:
アーカイブへのアセット、デバイスおよびデバイス・グループのエクスポート
この項では、アセット、デバイスおよびデバイス・グループのアーカイブを作成する様々な方法について説明します。次のトピックが含まれています:
「アセットのインポート(またはエクスポート)に必要な権限について」も参照してください。
WebCenter Portalからアーカイブへのアセットのエクスポート
管理者、アプリケーション・スペシャリストおよびポータル・マネージャは、WebCenter Portalからアセットをエクスポートできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のアセットのダウンロードに関する項を参照してください。
アーカイブへのデバイスおよびデバイス・グループのエクスポート
この項には次のトピックが含まれます:
WebCenter Portalを使用したデバイスおよびデバイス・グループのエクスポート
管理者は、WebCenter Portal管理から1つ以上のデバイスおよびデバイス・グループをファイル(.par
ファイル)にエクスポートできます。詳細は、「デバイスおよびデバイス・グループのライフ・サイクルの管理」を参照してください。
WLSTを使用したデバイスおよびデバイス・グループのエクスポート
管理者は、WLSTコマンドexportWebCenterResource
を使用して、WebCenter Portalの単一のデバイスまたはデバイス・グループをエクスポート・アーカイブ(.aar
ファイル)にエクスポートできます。
exportWebCenterResource(appName, fileName, resourceType, [resourceGUID, resourceName, spaceName, exportContentDirectory, server, applicationVersion])
コマンドの構文の詳細は、『WebCenter WLSTコマンド・リファレンス』のexportWebCenterResourceに関する項を参照してください。
WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。
次に例を示します。
例1: デバイス・グループのエクスポート
次の例では、WebCenter Portalの「MyMobileDeviceGroup」というデバイス・グループをエクスポートします。
exportWebCenterResource(appName='webcenter', fileName='myDeviceGroupExport.aar', resourceType='deviceGroup', resourceName='MyMobileDeviceGroup)
例2: デバイスのエクスポート
次の例では、WebCenter Portalの「MyMobileDevice」というデバイスをエクスポートします。
exportWebCenterResource(appName='webcenter', fileName='myDeviceExport.aar', resourceType='device', resourceName='MyMobileDevice)
WLSTを使用したアーカイブへのアセット、デバイスまたはデバイス・グループのエクスポート
管理者は、WLSTコマンドexportWebCenterResource
を使用して、単一アセット、デバイスまたはデバイス・グループをWebCenter Portalからエクスポートできます。
exportWebCenterResource(appName, fileName, resourceType, [resourceGUID, resourceName, spaceName, exportContentDirectory, server, applicationVersion])
設定するオプションは、エクスポートするアセット、デバイスまたはデバイス・グループによって異なります。コマンドの構文の詳細は、『WebCenter WLSTコマンド・リファレンス』のexportWebCenterResourceに関する項を参照してください。
WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。
次に例を示します。
例1: 「Sales」ポータルに属するページ・テンプレートのエクスポート
次の例では、Sales
ポータルのページ・テンプレートをmySalesPageTemplateExport.aar
というファイルにエクスポートします。
exportWebCenterResource(appName='webcenter', fileName='mySalesPageTemplateExport.aar', resourceType='pageTemplate', resourceGUID='gsr47d9a5ac_7398_439a_97d2_8b54ce905f7e, spaceName='SalesPortal')
例2: GUIDで識別する共有ポータル・スキンのエクスポート
次の例では、共有ポータル・スキンをmySharedSkinExport.aar
というファイルにエクスポートします。
exportWebCenterResource(appName='webcenter', fileName='mySharedSkinExport.aar', resourceType='skin', resourceGUID='gsr5a8c2fcc_bc7f_4cba_9254_36df58d66e60)
例3: 名前で識別する共有ポータル・スキンのエクスポート
次の例では、同じ共有ポータル・スキンをエクスポートしますが、GUIDではなくスキンの表示名を指定します。
exportWebCenterResource(appName='webcenter', fileName='mySharedSkinExport.aar', resourceType='skin', resourceName='MyCompanySkin)
例4: デバイス・グループのエクスポート
次の例では、WebCenter Portalの「MyMobileDeviceGroup」というデバイス・グループをエクスポートします。
exportWebCenterResource(appName='webcenter', fileName='myDeviceGroupExport.aar', resourceType='deviceGroup', resourceName='MyMobileDeviceGroup)
例5: デバイスのエクスポート
次の例では、WebCenter Portalの「MyMobileDevice」というデバイスをエクスポートします。
exportWebCenterResource(appName='webcenter', fileName='myDeviceExport.aar', resourceType='device', resourceName='MyMobileDevice)
REST APIを使用したアセットのエクスポート
Oracle WebCenter Portalには、特定のアセットをポータルまたは共有アセット領域からアーカイブ(.aar)にダウンロードするためのREST APIが用意されています。
REST APIを使用してアセットをエクスポートするには、次の形式のURLを使用します。
http://host:port/rest/api/v1/portal/typeOfAsset/assetId/archive?utoken=utokenvalue
ここで、typeOfAsset
はページ・テンプレート、スキン、視覚化テンプレート、リソース・カタログなどのエクスポートするアセットを示します。
アセットをエクスポートするには、wpfas/modules/rest-service/servlet/src/java/oracle/webcenter/jaxrs/services/portal/controller/
AssetTypeResource
.java
で、次の形式のGET操作を追加します
@GET
@Path("{id}/archive")
public Response exportPortal(@PathParam("id
") String id);
ここで、PathParamのid
はエクスポートされるアセットのショートIDです。
アーカイブからのアセットのインポート
WebCenter Portalのアセット・エクスポート・アーカイブ(.aar
ファイル)に以前に保存されたアセットのみをインポートできます。詳細は、「アーカイブへのアセット、デバイスおよびデバイス・グループのエクスポート」を参照してください。
インポート時:
-
既存のアセット、つまり、同じ内部IDを持つアセットが上書きされます。
-
ポータル・アセットは、常に同じポータルにインポートされます。リソースを別のポータルにインポートできません。
この項では、アセットをアーカイブからWebCenter Portalにインポートする様々な方法について説明します。次のトピックが含まれています:
アセットのインポート(またはエクスポート)に必要な権限について
表33-3に、WebCenter Portal管理を使用したアセットのインポート(またはエクスポート)に必要なロールと権限を示します。
注意:
WLSTを使用してアセットをインポート(またはエクスポート)するには、WebLogic ServerのMonitor
ロール(またはそれ以上のロール)も必要です。
表33-3 WebCenter Portalを使用したアセットのインポート(またはエクスポート)に必要な権限
アセット | WebCenter Portalの必要なロールまたは権限 | 説明 |
---|---|---|
共有アセット |
または |
|
共有アセット |
|
|
|
|
|
ポータル・アセット |
または |
|
ポータル・アセット |
|
|
|
|
WebCenter Portalを使用したアセットのアーカイブからのインポート
管理者、アプリケーション・スペシャリストおよびポータル・マネージャは、WebCenter Portalからアセットをインポートできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のアセットのアップロードに関する項を参照してください
WebCenter Portalを使用したデバイスおよびデバイス・グループのインポート
管理者は、WebCenter Portal管理を使用して1つ以上のデバイスおよびデバイス・グループをファイル(.par
ファイル)からインポートできます。詳細は、「デバイスおよびデバイス・グループのライフ・サイクルの管理」を参照してください。
WLSTを使用したアセットのアーカイブからのインポート
管理者は、WLSTコマンドimportWebCenterResource
を使用して、単一アセット、デバイスまたはデバイス・グループをWebCenter Portalにデプロイできます。
importWebCenterResource(appName, fileName, [resourceType, spaceName, overwriteContentDirectory, server, applicationVersion])
設定するオプションは、デプロイするアセット、デバイスまたはデバイス・グループによって異なります。コマンドの構文の詳細は、『WebCenter WLSTコマンド・リファレンス』のimportWebCenterResourceに関する項を参照してください。
WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。
次に例を示します。
例1: 「Sales」ポータルへのページ・テンプレートのデプロイ
次の例では、mySalesPageTemplateExport.aar
にアーカイブされているページ・テンプレートをSales
ポータルにインポートします。
importWebCenterResource(appName='webcenter', fileName='mySalesPageTemplateExport.aar', resourceType='pageTemplate', spaceName='SalesPortal')
例2: 共有ポータル・スキンのデプロイ
次の例では、mySharedSkinExport.aar
にアーカイブされている共有ポータル・スキンをインポートします。
importWebCenterResource(appName='webcenter', fileName='mySharedSkinExport.aar', resourceType='skin')
例3: デバイス・グループのデプロイ
次の例では、myDeviceGroupExport.aar
にエクスポートされたデバイス・グループをインポートします。
importWebCenterResource(appName='webcenter', fileName='myDeviceGroupExport.aar', resourceType='deviceGroup')
例4: デバイスのデプロイ
次の例では、myDeviceExport.aar
にアーカイブされているデバイスをインポートします。
importWebCenterResource(appName='webcenter', fileName='myDeviceExport.aar', resourceType='device')
REST APIを使用したアセットのインポート
Oracle WebCenter Portalには、特定のアセットをポータルまたは共有アセット領域からアーカイブ(.aar
ファイル)にダウンロードするためのREST APIが用意されています。
REST APIを使用してアセットをエクスポートするには、次の形式のURLを使用します。
http://host:port
/rest/api/v1/portal/portals/portalShortId/typeOfAsset
?utoken=utokenvalue
ここで、typeOfAsset
はページ・テンプレート、スキン、視覚化テンプレート、リソース・カタログなどのエクスポートするアセットで、portalShortId
はアセットがインポートされるポータルのショートIDを示します。
ポータルまたは共有アセット領域にアセットをインポートするには、wpfas/modules/rest-service/servlet/src/java/oracle/webcenter/jaxrs/services/portal/controller/PortalsReosurce.java
で、次の形式のPOST操作を追加します。
@POST @Consumes({MediaType.MULTIPART_FORM_DATA, MediaType.APPLICATION_OCTET_STREAM}) @Path("{portalId}/<typeOfAsset>") @ResourceType("urn:oracle:webcenter:portal:<assetType>") public Response importPortal(@PathParam("portalId") String portalId, MultiPart multiPartData);
ここで、PathParamのportalId
はアセットがインポートされるポータルのショートIDで、multipartData
はアップロードに使用されるファイルを含むマルチパート・データです。
POST操作を使用してアセットをインポートするには、コンテンツ・タイプがmultipart/form-data
として指定されている必要があります。マルチパート形式では、各パートはオブジェクトのデータの連続する部分です。各オブジェクトのパートは、個別に任意の順序でアップロードできます。いずれかのパートの送信が失敗した場合は、他のパートに影響を与えることなくそのパートを再送信できます。また、POST操作でfileName
キーにマップされるアセット・アーカイブのファイル名が必要です。
共有アセットをインポートする場合、次の形式のURLも使用できます。
http://host:port/rest/api/v1/portal/typeOfAsset?utoken=utokenvalue
共有アセットをインポートするには、wpfas/modules/rest-service/servlet/src/java/oracle/webcenter/jaxrs/services/portal/controller/AssetTypeResource.java
で、次の形式のPOST操作を追加します。
POST @Consumes({MediaType.MULTIPART_FORM_DATA, MediaType.APPLICATION_OCTET_STREAM}) @ResourceType("urn:oracle:webcenter:portal:<assetType>") public Response importPortal(MultiPart multiPartData)
カスタム共有ライブラリの拡張機能のデプロイ
開発者は、JDeveloperを使用して、ポータルのカスタムADFライブラリ・コンポーネント(管理対象Bean、タスク・フローおよびデータ・コントロールなど)を構築したり、これらのコンポーネントを共有ライブラリの拡張機能としてポータル・サーバーにデプロイしたりすることができます。
Oracle WebCenter Portalの開発の「共有ライブラリの開発」も参照してください。
共有ライブラリがポータルによって使用される場合、ポータルのデプロイまたは伝播中にそれらを他のインスタンスにプッシュするよう選択できます。
ステージングから本番への接続の詳細の移動
管理者は、WLSTコマンドexportWebCenterPortalConnections
およびimportWebCenterPortalConnections
を使用して、あるWebCenter Portalインストールの接続の詳細を別のWebCenter Portalインストールに移行できます。これらのコマンドは、ポータルをインポートまたはリストアする際に、ソース・サーバーで使用される接続(ポートレット・プロデューサ接続やWebサービス接続など)がターゲット・サーバーに存在しない場合に役立ちます。
移行できる接続タイプの詳細は、「接続プロパティ・ファイルの理解」を参照してください。
この項には次のトピックが含まれます:
ファイルへのWebCenter Portal接続の詳細のエクスポート
WebLogic ServerのOperator
ロール(あるいはそれ以上のロール)を持っている場合、WLSTコマンドexportWebCenterPortalConnections
を使用して、特定のWebCenter Portalインストールに現在構成されている接続情報をファイルにエクスポートできます。
exportWebCenterPortalConnections(appName, fileName, [connectionType, connectionName, logFile, server, applicationVersion])
注意:
特定のポータルの接続はエクスポートできません。接続は、すべてのポータル間で共有されます。
設定するオプションは、エクスポートする接続情報によって異なります。コマンドの構文の詳細は、『WebCenter WLSTコマンド・リファレンス』のexportWebCenterPortalConnections
に関する項を参照してください。
WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。
次に例を示します。
例1: WSRPプロデューサおよび外部アプリケーションのすべての接続をファイルにデプロイする場合
次の例では、WSRPプロデューサと外部アプリケーションの接続のみを、myconnection.properties
というファイルにエクスポートします。
exportWebCenterPortalConnections(appName='webcenter', fileName='/myConnections/myconnection.properties', connectionType='wsrpProducerConnection,externalAppConnection')
例2: 特定のWSRPプロデューサ接続をファイルにデプロイする場合
次の例では、MyWSRP1
およびMyWRSP2
という2つのWSRPプロデューサ接続の接続構成情報をエクスポートします。
exportWebCenterPortalConnections(appName='webcenter', fileName='/myConnections/connection.properties', connectionType='wsrpProducerConnection', connectionName='MyWSRP1,MyWSRP2')
ファイルからの新しいWebCenter Portal接続のインポート
WebLogic ServerのOperator
ロール(あるいはそれ以上のロール)を持っている場合、WLSTコマンドimportWebCenterPortalConnections
を使用して、あるWebCenter Portalインストールからエクスポートされた接続情報を別のWebCenter Portalインストールにデプロイできます。
importWebCenterPortalConnections(appName, fileName, [promptForPassword, logFile, server, applicationVersion])
ターゲットには、新しい接続のみがインポートされます。ターゲットにすでに存在する接続は無視されます。ソース接続情報は、WLSTコマンドexportWebCenterPortalConnections
を使用してエクスポートする必要があります。この方法を確認するには、「ファイルへのWebCenter Portal接続の詳細のエクスポート」を参照してください。
必要な場合、ターゲットに接続情報をデプロイする前に、接続情報を含むファイルを編集できます。「接続プロパティ・ファイルの理解」も参照してください。
例1: ファイルからの接続のインポート
次の例では、/myConnections
にあるmyconnection.properties
というファイルで定義される接続をインポートします。接続のインポート操作に関する詳細情報のログは、importConnection.log
にも記録されます。
importWebCenterPortalConnections(appName='webcenter', fileName='/myConnections/myconnection.properties',logFile='importConnection.log')
例2: 資格証明が必要な接続のインポート
次の例では、/myConnections
にあるmyconnection.properties
というファイルで定義される接続をインポートし、必要な場合は資格証明のプロンプトを表示します。
importWebCenterPortalConnections(appName='webcenter', fileName='/myConnections/myconnection.properties', promptForPassword=1)
コマンドの構文の詳細は、『WebCenter WLSTコマンド・リファレンス』のimportWebCenterPortalConnections
に関する項を参照してください。
WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。
ポータルのディスカッションとページレット・プロデューサのリソースの移行
1つ以上のポータルを別のサーバーに移動または移行した後、各種バックエンド・コンポーネントで格納されているポータル・データを(オプションで)移行できます。ディスカッションとページレット・プロデューサのリソースがポータルで使用される場合、これにこれらの移行が含まれます。
ディスカッション
ページレット:
1つ以上のポータルをインポートした後で、Oracle Secure Enterprise Searchクロールを開始して、新たにインポートされたデータを索引付けすることを検討してください。
アーカイブへのポータル・ディスカッションのエクスポート
ディスカッション・サーバーの管理コンソールを使用して、特定のポータルに関連付けられているディスカッションをエクスポートします。
ポータル・ディスカッションが.xml
ファイルにエクスポートされ、DOMAIN_HOME/config/fmwconfig/servers/<target_server_name>/owc_discussions/data/
ディレクトリの.zip
ファイルに保存されます。
DOMAIN_HOME
は、Oracle WebLogic Serverドメインのパスです。例, MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/WC_Collaboration/owc_discussions/data/
ポータルのディスカッションをエクスポートするには:
-
ディスカッション・サーバーの管理コンソールにログインします。
コンソールのURLがわかっている場合は、直接ログインできます。例:
http://example.com:8890/owc_discussions/admin
または、次のようにWebCenter Portalからログインします。
-
WebCenter Portal管理を開きます。
詳細は、「WebCenter Portal管理の設定ページの理解」を参照してください。
-
「ポータル」をクリックします。
-
ディスカッションをエクスポートするポータルを選択して、「管理」を選択します。
-
「ツールとサービス」、「ディスカッション」の順にクリックします。
-
このポータルに関連付けられている「フォーラム名」/「フォーラムID」または「カテゴリ名」/「カテゴリID」を書き留めます。
WebCenter Portalのディスカッション・サーバーは、ディスカッション・カテゴリおよびフォーラムIDを順番に生成します。ターゲット・システムにこのIDが存在する場合、インポートされたフォーラム(またはカテゴリ)には新しい一意のIDが割り当てられるため、インポートされたポータルが新しいIDをポイントするように再構成する必要があります。詳細は、後述の手順11を参照してください。
-
「フォーラムの管理」をクリックして、ディスカッション・サーバーの管理コンソールにログインします。
-
-
管理コンソールで、「システム」メニューを選択し、サイドバーで、「XMLインポートおよびエクスポート」を選択します。
-
「データのエクスポート」を選択します。
-
次のオプションを設定します(図33-15)。
-
エクスポート・オプション: 「カスタム・オプション」を選択し、すべてのチェック・ボックスを選択します。
-
コンテンツのエクスポート: 「特定のコンテンツのエクスポート」を選択して、必要なフォーラムまたはカテゴリの名前を選択します。
注意: 複数のフォーラムをサポートするポータルは、カテゴリを使用してディスカッションを格納します。他のポータルは単一フォーラムを使用します。
-
エクスポート場所、エクスポート・ファイル名、エクスポート・ファイルのエンコーディング: デフォルト値を保持します。
-
-
「エクスポートの開始」をクリックします。
-
完了したら、
MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/<server_name>/owc_discussions/data
ディレクトリからターゲット・ディスカッション・サーバーの同じ場所に.zip
ファイル(エクスポート.xml
ファイルを含む)をコピーします。例:
MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/WC_Collaboration/owc_discussions/data
ターゲット・システムにディスカッションをインポートする前に、移行するポータルがターゲット上に存在している必要があります。「WebCenter Portal管理を使用したポータルのアーカイブからのインポート」を参照してください。
アーカイブからのポータル・ディスカッションのインポート
ディスカッション・サーバーの管理コンソールを使用して、別のWebCenter Portal環境からエクスポートされたディスカッションをインポートします。
ディスカッション・データをインポートする前に、関連するポータルがターゲット上に存在することを確認します。「ポータル・アーカイブのインポートとエクスポート」または「WLSTを使用したポータルの直接デプロイ」を参照してください。
注意:
WebCenter Portalのディスカッション・サーバーは、ディスカッション・カテゴリおよびフォーラムIDを順番に生成します。このため、2つのターゲット間(または、ソースとターゲット間)でディスカッション・データをインポートする場合、両方のシステムに同じIDが存在する可能性があります。IDのクラッシュが発生した場合、インポートされたフォーラム(またはカテゴリ)には新しい一意のIDが割り当てられるため、ポータルが新しいIDをポイントするように再構成する必要があります。詳細は、後述の手順11を参照してください。
特定のポータルのディスカッションをインポートするには:
-
ターゲットのディスカッション・サーバーの管理コンソールにログインします。
コンソールのURLがわかっている場合は、直接ログインできます。例:
http://example.com:8890/owc_discussions/admin
または、次のようにWebCenter Portalからログインします。
-
WebCenter Portal管理を開きます。
詳細は、「WebCenter Portal管理の設定ページの理解」を参照してください。
-
「ポータル」をクリックします。
-
データをインポートするポータルを選択して、「管理」を選択します。
-
「ツールとサービス」、「ディスカッション」の順にクリックします。
-
「フォーラムの管理」(右端)をクリックし、管理コンソールにログインします。
-
-
管理コンソールで、「システム」メニューを選択し、サイドバーで、「XMLインポートおよびエクスポート」を選択します。
-
「データのインポート」を選択します。
-
利用可能なリストから適切なインポート・ファイルを選択します(図33-16)。
必要なファイルがリスト表示されていない場合は、ソース・ディレクトリ
DOMAIN_HOME/config/fmwconfig/servers/<target_server_name>/owc_discussions/data/
からこのターゲット上の同じ場所にエクスポート.zip
ファイルをコピーします。「アーカイブへのポータル・ディスカッションのエクスポート」も参照してください。DOMAIN_HOME
は、Oracle WebLogic Serverドメインのパスです。例:MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/WC_Collaboration/owc_discussions/data/
-
「インポートの開始」をクリックします。
インポート時に、ディスカッション・データはディスカッション・サーバーにコピーされます。次の手順で、以前に移行したポータルを、この新たにインポートされたデータと再度関連付けます。
-
「コンテンツ」メニューを選択し、サイドバーで「コンテンツ・サマリー」を選択します。
システムのすべてのカテゴリおよびフォーラムがここにリスト表示されます。
-
「WebCenter」を選択し、新たにインポートされたフォーラムまたはカテゴリの「移動」ボタンをクリックします。
-
ターゲットWebCenter Portalのルート・カテゴリを選択し、カテゴリの移動をクリックします。
「カテゴリのサマリー」ページに新しい場所が表示されます。
-
サイドバーの「権限」をクリックします。
-
ユーザー・タイプ: 「すべてのユーザー」および「登録済のユーザー」のすべての権限を解除し、「変更の保存」をクリックします(図33-17)。
-
WebCenter Portalで、ポータルのディスカッション・フォーラム設定に移動して、ポータルと、インポートしたばかりのディスカッション・データを再度関連付けます。
-
WebCenter Portal管理を開きます。
詳細は、「WebCenter Portal管理の設定ページの理解」を参照してください。
-
「ポータル」をクリックします。
-
データをインポートするポータルを選択して、「管理」を選択します。
-
「ツールとサービス」、「ディスカッション」の順にクリックします。
-
「カテゴリID」または「フォーラムID」の横の「検索」アイコンをクリックし、リストからインポート済カテゴリ(またはフォーラム)を選択して、
「選択」
をクリックします。 -
「保存」をクリックします。
-
本番でのポータルの伝播および再デプロイ
この項には次のトピックが含まれます:
ポータル伝播の理解
管理者は、ステージング環境と本番環境が接続されて「同期」状態の場合、ステージングのポータルの変更を本番に伝播できます。たとえば、新しいページや追加または変更されたアセットなどのポータルの変更を伝播できます。常に最初にステージングの変更を行い、その後デプロイメントまたは伝播を使用してポータルの変更を本番にプッシュすることを強くお薦めします。伝播によって、本番サーバーの再起動が必要になることも、停止時間が発生することもありません。
ステージングから本番に伝播される変更のリストは、表33-4を参照してください
表33-4 本番に伝播されるポータルの変更
伝播されるポータルの変更 | はい/いいえ |
---|---|
ポータル・ページ |
はい |
アセット |
はい |
ポートレット |
はい |
ポータル・フォルダ・コンテンツの変更 |
はい |
ポータルのアクティビティおよび使用状況データ (アクティビティ・ストリーム、カレンダ・イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイル、アンケート) |
いいえ |
カスタム・ページ・セキュリティを除くポータル・セキュリティ・データ (ポータル・ロールおよび権限、メンバーの詳細とそのロールの割当て) |
いいえ |
ポータルで参照される外部コンテンツ (ポータル・ページ、ポータル・アセット、コンテンツ・プレゼンタ表示テンプレート、Site Studioなどで参照) |
いいえ |
外部サーバーに格納されるデータ (ディスカッション、メール、お知らせ、分析、カスタム・タスク・フローおよび共有ライブラリ) |
いいえ |
ポータルの構造上の変更の場合は再デプロイメントが必要です。
-
ポータル・ページに対して、カスタム・セキュリティを設定できます。ポータルの伝播中に、カスタム・ページ・セキュリティの変更が伝播されます。ただし、既存のロール(ソース・サーバーとターゲット・サーバーの両方に存在するロール)に対するポータルレベルのセキュリティの変更のみが伝播されます。新しいロールを作成し、新しいページ権限を追加するか、メンバーを追加または削除した場合は、新しいロールがターゲット・サーバーに存在しないと、変更が伝播されません。そのような変更を移行するには、ポータルを再デプロイする必要があります。
- ポータルをデプロイした後に、ドキュメントなどの新しいツールを有効化したり、ソース・サーバーでそれを無効化した後でポータルの変更を伝播した場合は、ツール関連の変更がターゲット・サーバーに反映されません。変更を有効にするには、ポータルを再デプロイする必要があります。
WLSTを使用したポータル変更の伝播
ポータルの直接伝播は、ソース環境とターゲット環境との間に接続が存在し、ポータルが以前にWLSTコマンドdeployWebCenterPortals
を使用してターゲットに直接デプロイされた場合のみ可能です。「WLSTを使用したポータルの直接デプロイ」を参照してください。
ステージングから本番にメタデータ変更を伝播するには:
いくつか例を挙げます。
例1: ポータルのメタデータ変更の伝播
次のコマンドでは、本番サーバーへの接続(MyProductionConnection
)を作成し、myPortal
というポータルの変更をターゲット・サーバーに伝播します。
adf_createHttpURLConnection(appName='webcenter', name='MyProductionConnection', url='http://example.com:7777', user='myuser', password='mypassword', realm='ProductionRealm') propagateWebCenterPortal(appName='webcenter', portalName='myPortal', targetConnectionName='MyProductionConnection')
例2: ポータルのメタデータ変更を伝播する前にターゲット・ポータルをバックアップする場合
次の例では、ターゲットでmyPortal
をバックアップして、ポータル・コンテンツおよびポータルで使用される共有アセットに対するすべての変更を含む、ポータルの変更を伝播し、さらに伝播ログ・ファイルの名前と場所を指定します。
propagateWebCenterPortal(appName='webcenter', portalName='myPortal', targetConnectionName='MyProductionConnection', savePortal=1 propagateLog='/mypropagationlogs/myPortal_propagation.log', propagateSharedAssets=1, propagatePortalContent=1,)