Oracle® Fusion Middleware

Oracle Managed File Transferの使用

12cリリース(12.1.3)

E56237-08(原本部品番号:E37983-09)

2016年11月

このドキュメントでは、Oracle Managed File Transferを管理する方法、ファイル転送の設計と監視を行う方法、およびOracle Managed File Transferを他のアプリケーションと統合する方法について説明します。

Oracle Fusion Middleware Oracle Managed File Transferの使用, 12c リリース(12.1.3)

E56237-08

Copyright © 2014, 2016, Oracle and/or its affiliates. All rights reserved.

原本著者: Oracle Corporation

原本協力者: Oracle Corporation

協力者: Oracle MFTの開発、製品管理および品質保証チーム

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 Oracle Managed File Transferの理解

- 1.1 Oracle Managed File Transferで実行できる機能

- 1.2 Oracle Managed File Transfer、Oracle Service BusおよびOracle B2B

- 1.3 Oracle Managed File Transferの機能的なユース・ケース・パターン

- 1.3.1 スタンドアロン・アプリケーション

- 1.3.2 SOA統合

- 1.3.3 B2B統合

- 1.3.4 Healthcare統合

- 1.3.5 Oracle Service Bus統合

- 1.3.6 ハイブリッド統合

- 1.4 Oracle Managed File Transferのアーキテクチャ

- 1.5 Oracle Managed File Transferのコンポーネント

- 1.5.1 アーティファクト: ソース、ターゲットおよび転送

- 1.5.2 埋込みFTPサーバーと埋込みsFTPサーバー

- 1.5.3 監視とレポート

- 1.5.4 セキュリティ

- 1.5.5 ユーティリティ

- 1.5.6 リポジトリ

- 1.5.7 インタフェース

- 1.6 Oracle Managed File Transferのユーザー・ロール

- 1.6.1 ファイル・ハンドラ

- 1.6.2 デザイナ

- 1.6.3 モニター

- 1.6.4 管理者

- 1.7 Oracle Managed File Transferのインストール

- 1.8 Oracle Managed File Transferの画面移動

- 1.8.1 「設計」、「監視」および「管理」の各ページ

- 1.8.2 左側のパネルのナビゲータの使用

- 1.8.3 動的なタブの開閉

- 1.8.4 ソースとターゲットの転送へのドラッグ・アンド・ドロップ

- 1.8.5 ダッシュボードの領域の開閉

- 1.8.6 言語、タイムゾーンおよびアクセシビリティ・プリファレンスの設定

2 アーティファクト(ソース、ターゲットおよび転送)の設計

- 2.1 転送の設計について

- 2.1.1 転送を作成するための準備

- 2.1.2 エンドツーエンド・フローの設計

- 2.2 転送の構成

- 2.2.1 ソースとターゲットの追加

- 2.2.2 コンテンツ・フィルタの設定

- 2.2.3 ターゲット固有の転送設定の構成

- 2.2.4 転送の前処理と後処理のアクションの設定

- 2.2.4.1 前処理での圧縮および圧縮解除アクション

- 2.2.4.2 前処理での暗号化および復号化アクション

- 2.2.4.2.1 PGP用の暗号化アルゴリズムの変更

- 2.2.4.3 後処理での圧縮解除

- 2.2.5 既存の転送の複製

- 2.3 ソースの作成

- 2.3.1 ソース・タイプ

- 2.3.1.1 FTP埋込みソース・タイプ

- 2.3.1.2 sFTP埋込みソース・タイプ

- 2.3.1.3 FTPリモート・ソース・タイプ

- 2.3.1.3.1 MVS転送のFTPリモート・ソース拡張プロパティ

- 2.3.1.4 sFTPリモート・ソース・タイプ

- 2.3.1.5 ファイル・ソース・タイプ

- 2.3.1.6 SOAP Webサービス・ソース・タイプ

- 2.3.1.7 SOAソース・タイプ

- 2.3.1.8 Service Busソース・タイプ

- 2.3.1.9 B2Bソース・タイプ

- 2.3.1.10 Healthcareソース・タイプ

- 2.3.1.11 ODIソース・タイプ

- 2.3.2 ソース処理アクションの設定

- 2.3.2.1 ソースでの圧縮と圧縮解除

- 2.3.2.2 ソースでの暗号化と復号化

- 2.3.3 配信前のファイルのアーカイブと削除

- 2.3.4 既存のソースの複製

- 2.4 ターゲットの作成

- 2.4.1 ターゲット・タイプ

- 2.4.1.1 FTPリモート・ターゲット・タイプ

- 2.4.1.1.1 MVS転送のFTPリモート・ターゲット設定

- 2.4.1.2 sFTPリモート・ターゲット・タイプ

- 2.4.1.3 ファイル・ターゲット・タイプ

- 2.4.1.4 SOAP Webサービス・ターゲット・タイプ

- 2.4.1.5 SOAターゲット・タイプ

- 2.4.1.6 Service Busターゲット・タイプ

- 2.4.1.7 B2Bターゲット・タイプ

- 2.4.1.8 Healthcareターゲット・タイプ

- 2.4.1.9 ODIターゲット・タイプ

- 2.4.2 配信後のファイルの移動と名前変更

- 2.4.3 既存のターゲットの複製

- 2.4.4 再試行間隔および再試行回数

- 2.5 スケジュールの設定

- 2.5.1 ポーリング頻度および最小経過時間を使用したスケジュール

- 2.6 転送のデプロイとテスト

- 2.6.1 ソース、ターゲットまたは転送のデプロイ

- 2.6.2 転送結果の通知方法

- 2.6.2.1 受信したファイルの検出

- 2.7 転送のインポートとエクスポート

3 カスタム・コールアウトによる転送の処理

- 3.1 カスタム・コールアウトの理解

- 3.2 カスタム・コールアウトの作成: 概略手順

- 3.3 コードの作成

- 3.3.1 Javaコードに関する要件とヒント

- 3.3.2 改行変換例のJavaコード

- 3.4 コールアウト定義ファイルの作成

- 3.5 コールアウト・ディレクトリの位置特定

- 3.6 createCalloutsコマンドの実行

- 3.7 コールアウトのテスト

- 3.7.1 ソースへのコールアウトの追加

- 3.7.2 ターゲットへのコールアウトの追加

- 3.7.3 コールアウト・アクションを確認するためのレポートの表示

- 3.7.4 コールアウトの更新

- 3.8 参照ファイル

- 3.8.1 PreCalloutPluginインタフェース

- 3.8.2 PostCalloutPluginインタフェース

- 3.8.3 コールアウト定義スキーマ

- 3.9 カスタム・コールアウトを使用した検証

4 Oracle Managed File Transferと他の製品の統合

- 4.1 互換性のあるテクノロジと統合戦略

- 4.2 ドメインの管理

- 4.2.1 トラッキングURLの指定

- 4.3 Oracle SOA Suiteとの統合

- 4.3.1 SOAソースのMFT参照の作成

- 4.3.2 SOAターゲットのMFTサービスの作成

- 4.3.3 連結されたSOAレポートとMFTレポート

- 4.4 Oracle Service Busとの統合

- 4.4.1 Service Busソースのビジネス・サービスの作成

- 4.4.1.1 Oracle JDeveloperでのビジネス・サービスの作成

- 4.4.1.2 Oracle Service Busコンソールでのビジネス・サービスの作成

- 4.4.2 Service Busターゲットのプロキシ・サービスの作成

- 4.4.2.1 Oracle JDeveloperでのプロキシ・サービスの作成

- 4.4.2.2 Oracle Service Busコンソールでのプロキシ・サービスの作成

- 4.5 B2Bとの統合

- 4.5.1 B2Bソースのリモート取引パートナ・チャネルの作成

- 4.5.2 B2BターゲットのB2Bドメインの構成

- 4.5.3 連結されたB2BレポートとMFTレポート

- 4.6 Healthcareとの統合

- 4.6.1 Healthcareソースのアウトバウンド・エンドポイントの作成

- 4.6.2 Healthcareターゲットのインバウンド・エンドポイントの作成

- 4.6.3 連結されたHealthcareレポートとMFTレポート

- 4.7 Oracle Data Integratorとの統合

- 4.7.1 ODI統合でのファイル・システムとFTPの使用

- 4.7.2 ODIソースのWebサービスの起動

- 4.7.3 ODIターゲットのデータ・サービスの作成

- 4.8 Webサービスとの統合

- 4.9 MFT WSDLファイル

5 Oracle Managed File Transferの監視

- 5.1 デプロイ済のソース、ターゲットおよび転送の監視

- 5.1.1 ソース、ターゲットおよび転送の無効化

- 5.1.2 ソース、ターゲットおよび転送の再有効化

- 5.1.3 ソース、ターゲットおよび転送のアンデプロイ

- 5.1.4 ソース、ターゲットおよび転送の再デプロイ

- 5.1.5 ソース、ターゲットおよび転送のバージョニング

- 5.2 メイン・ダッシュボードを使用した転送フローの監視

- 5.2.1 メイン・ダッシュボードのメトリックの解釈

- 5.2.2 ファイル・ファインダの使用

- 5.2.3 アクティブな配信の監視

- 5.3 すべての転送、ソースまたはターゲットのダッシュボードの解釈

- 5.3.1 インスタンス・メッセージの解釈

- 5.3.2 ダッシュボードのメトリックの解釈

- 5.4 単一アーティファクトの転送、ソースおよびターゲットのダッシュボードの解釈

- 5.4.1 アーティファクト・インスタンス・メッセージの解釈

- 5.4.2 アーティファクト情報の解釈

- 5.4.3 アーティファクト・ダッシュボードのメトリックの解釈

- 5.5 ソース、転送およびターゲットのレポートの解釈

- 5.5.1 フロー・ダイアグラムの使用

- 5.5.2 ソース・レポート

- 5.5.3 転送レポート

- 5.5.4 ターゲット・レポート

- 5.6 転送の一時停止と再開

- 5.7 転送の再送信

- 5.8 ファイル配信失敗の診断

- 5.9 転送エラーの診断

- 5.9.1 診断エラー・メッセージおよび説明

6 Oracle Managed File Transferの管理

- 6.1 サーバーのプロパティの変更

- 6.1.1 一般的なサーバー構成プロパティ

- 6.1.2 パフォーマンス・プロパティ

- 6.1.3 高可用性プロパティ

- 6.1.4 拡張配信プロパティ

- 6.2 MFT構成のインポートとエクスポート

- 6.3 大量ファイル転送のパフォーマンス向上のためのメモリー増加

- 6.4 Oracle WebLogic Serverの起動と停止

- 6.5 ファイアウォールを通してファイルを転送するためのMFT FTPプロキシ・サーバーの使用

- 6.6 複数のWeblogic Serverと高可用性の管理

- 6.6.1 高可用性の構成

- 6.6.2 クラスタ起動エラーの防止

- 6.6.3 Oracle Managed File Transferでのロード・バランシング

- 6.7 イベント通知の有効化

- 6.7.1 通知のための電子メール・ドライバの構成

- 6.7.2 通知のためのSMSドライバの構成

- 6.8 MFTExceptionQueue

- 6.9 Oracle Managed File Transferのエラー・プロセッサ・キューの構成

- 6.10 Oracle Managed File Transferのログ出力の構成

- 6.11 Oracle Managed File Transferのログ出力

- 6.12 Oracle Managed File Transferのログ・メッセージの表示

- 6.13 別の環境へのOracle Managed File Transferの移動

7 Oracle Managed File Transfer埋込みサーバーの管理

- 7.1 埋込みFTPおよびsFTPサーバーについて

- 7.1.1 セキュリティ

- 7.1.2 転送およびファイルのアーカイブおよびパージ

- 7.2 埋込みサーバー構成

- 7.2.1 ポートの再構成

- 7.2.2 リモートのFTPおよびsFTPサーバーのパス・セパレータ

- 7.2.3 その他の埋込みサーバーの設定

- 7.3 埋込みサーバーの起動と停止

- 7.4 埋込みサーバーと高可用性の管理

- 7.5 サポートされるFTPおよびsFTPのコマンド

8 Oracle Managed File Transferのセキュリティ

- 8.1 ユーザーの認証および認可

- 8.1.1 ユーザーの構成

- 8.1.2 Oracle Managed File Transferコンソール・アクセス

- 8.1.3 埋込みサーバーのユーザー・アクセス

- 8.1.4 ペイロード・アクセスの許可

- 8.2 埋込みサーバーのセキュリティ

- 8.2.1 sFTP (SSH-FTP)

- 8.2.2 FTPS (FTP Over SSL)

- 8.3 シングル・サインオンのためのOracle Access Manager 11gとの統合

- 8.4 PGPを使用したメッセージ暗号化

- 8.5 キーストアの管理

- 8.5.1 SSLキーストアの構成

- 8.5.2 SSHキーストアの構成

- 8.5.3 PGPキーストアの構成

- 8.6 セキュリティ監査ロギングの有効化

- 8.6.1 監査ロギングを有効化するためのFusion Middleware Controlの使用

- 8.6.2 監査ロギングを有効化するためのWLSTの使用

- 8.7 OWSMセキュリティ・ポリシー・アタッチメント

- 8.7.1 グローバル・ポリシー・アタッチメントのためのFusion Middleware Controlの使用

- 8.7.1.1 ポリシー資格証明の管理

- 8.7.1.2 ソースのポリシー・セットの作成

- 8.7.1.3 ターゲットのポリシー・セットの作成

- 8.7.2 グローバル・ポリシー・アタッチメントのためのWLSTの使用

- 8.7.3 ローカル・ポリシー・アタッチメントのためのMFTコンソールの使用

- 8.7.4 ローカル・ポリシー・アタッチメントのためのWLSTの使用

- 8.7.5 実行時のポリシー適用方法

- 8.7.6 ポリシーおよびアーティファクトのライフ・サイクル管理

- 8.7.7 ポリシー登録の検証

- 8.8 Oracle Managed File TransferのSSL専用ドメインの構成

- 8.8.1 SSL専用ドメインの有効化

9 Oracle Managed File Transferのユーティリティ

- 9.1 WLSTコマンドの実行

- 9.2 MFTのWLSTコマンドの要約

- 9.3 Oracle Managed File Transfer EJB

はじめに

ここでは、対象読者、関連ドキュメント、およびこのガイド(『Oracle Fusion Middleware Oracle Managed File Transferの使用』)で使用している表記規則について説明します。

対象読者

このドキュメントは、Oracle Managed File Transferで実装されるファイル配信の管理者、設計者、デプロイ担当者および監視担当者を対象にしています。すべてのユーザーがFTP(ファイル転送プロトコル)とWebサービスに習熟していることをお薦めします。

管理者の場合、Oracle WebLogic ServerとOracle Databaseの管理にも習熟していることをお薦めします。

設計者の場合、Oracle SOA Suite、Oracle Service Bus、Oracle B2B for Healthcareなどの製品との統合にも習熟していることをお薦めします。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティへの取り組みについては、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)にアクセスしてください。

Oracleサポートへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info、聴覚に障害があるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

関連ドキュメント

Oracle SOA Suite製品については、次を参照してください。

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』

- Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド

- Oracle Fusion Middleware Oracle SOA Suiteインストレーション・ガイド

- Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド

- Oracle Fusion Middlewareパフォーマンス・ガイド

表記規則

このマニュアルでは次の表記規則を使用します。

表記規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 Oracle Managed File Transferの理解

Oracle Managed File Transfer (MFT)は、エンド・ツー・エンドで高いパフォーマンスで動作する標準ベースの管理対象ファイル・ゲートウェイです。ファイルの暗号化、スケジューリング、埋込みFTPサーバーと埋込みsFTPサーバーなどの機能を備えた軽量なWebベースのデザインタイム・コンソールで、ファイル転送の設計、デプロイメントおよび監視を実行できます。この章では、Oracle Managed File Transferの基本概念について説明します。

この章の内容は次のとおりです。

- Oracle Managed File Transferで実行できる機能

- Oracle Managed File Transfer、Oracle Service BusおよびOracle B2B

- Oracle Managed File Transferの機能的なユース・ケース・パターン

- Oracle Managed File Transferのアーキテクチャ

- Oracle Managed File Transferのコンポーネント

- Oracle Managed File Transferのユーザー・ロール

- Oracle Managed File Transferのインストール

- Oracle Managed File Transferの画面移動

注意:
使用しているスキンによっては、このガイドで示される画面は実装状態と異なる場合があります。相違点は軽微なものです。

1.1 Oracle Managed File Transferで実行できる機能

この項では、Oracle Managed File Transferを使用することで実行できる様々な操作を説明します。

Oracle Managed File Transferを使用して、転送プロセスで次の操作を実行できます。

- スケジュール

- 再送信

- インラインで添付または参照

- 圧縮と解凍

- 暗号化と復号

- アーカイブ、名前の変更および削除

- 転送インスタンスとファイルのパージ

- 一時停止と再開

転送の再送信の詳細は、「転送の再送信」を参照してください。他の操作の詳細は、「アーティファクト(転送、ソースおよびターゲット)の設計」を参照してください。

Oracle Managed File Transferでは、次の情報に基づいて、ファイル配信(転送インスタンス)を追跡およびトラブルシューティングできます。

- 正常終了、頻度および失敗の統計

- メトリック、最新のエラー、ファイル・ファインダおよびアクティブな配信

- エラー情報表

- アクティブ配信進行状況表

- 個々の配信のレポート

詳細は、「Oracle Managed File Transferの監視」を参照してください。

Oracle Managed File Transferでは、次に示す様々なエンドポイント・タイプとの間でファイルを転送できます。

- FileベースおよびFTPベースのエンドポイント・タイプ:

- File: Oracle Managed File Transferサーバーがアクセス可能なディレクトリとの間でファイルを転送します。

- FTP埋込み: 埋込みMFT FTP (File Transfer Protocol)サーバーまたはFTPS (FTP with Secure Socket Layer)サーバーがファイルを埋込みサーバー・ディレクトリにコピーすることによってファイルを転送します。

- sFTP埋込み: 埋込みsFTP (Secure Shell FTPまたはSSH-FTP)サーバーがファイルを埋込みサーバー・ディレクトリにコピーすることによってファイルを転送します。

- FTPリモート: リモートのFTPサーバーまたはFTPSサーバーとの間でファイルを転送します。

- sFTPリモート: リモートのsFTPサーバーとの間でファイルを転送します。

- SOAP Webサービス・ベースのエンドポイント・タイプ:

- SOAP: インラインで、またはフォルダの場所への参照を使用して、Simple Object Access Protocol Webサービス・エンドポイントとの間でファイルを転送します。

- SOA: Oracle SOA (Service-Oriented Architecture) Webサービス・エンドポイントとの間でファイルを転送します。

- Service Bus (OSB): Oracle Service Bus Webサービス・エンドポイントとの間でファイルを転送します。

- ODI: Oracle Data Integrator Webサービス・エンドポイントとの間でファイルを転送します。

- B2Bベースのエンドポイント・タイプ:

- B2B: Oracle B2B (Business to Business)取引パートナとの間でファイルを転送します。

- Healthcare: Oracle B2B for Healthcareエンドポイントとの間でファイルを転送します。

これらの転送をコンテキストで使用する例は、「Oracle Managed File Transferの機能的なユース・ケース・パターン」を参照してください。これらの転送の作成方法の詳細は、「アーティファクト(転送、ソースおよびターゲット)の設計」を参照してください。

1.2 Oracle Managed File Transfer、Oracle Service BusおよびOracle B2B

Oracle Managed File Transfer、Oracle SOA SuiteおよびB2Bの機能は重複していますが、それぞれ最適なファイル転送シナリオは異なります。

次のシナリオでは、Oracle Managed File Transferが最も適しています。

- オペレーティング・システムおよびファイル・システムの容量によってのみサイズが制限される大容量ファイルの転送。

- 1つのソースから多数のターゲットへのファンアウト式の転送。

- すべての転送の詳細な監査と記録

- 高度なセキュリティによる転送

- 再起動、一時停止/再開などの高度な転送管理

- 埋込みFTPサーバーまたは埋込みsFTPサーバーの使用

次のシナリオでは、Oracle SOA Suiteが最も適しています。

- オーケストレーションまたは複雑な統合(複数のソースからのファンインなど)

- メッセージングやERPなどの企業システムとの統合

- 手動タスク、コンテンツ・ベース・ルーティングまたは変換の実行

次のシナリオでは、B2Bが最も適しています。

- 関連するドキュメント形式(HL7、EDIなど)を対象とするシナリオ

- AS2などのセマンティクスを追加する必要があるシナリオ

1.3 Oracle Managed File Transferの機能的なユース・ケース・パターン

Oracle Managed File Transferは、複雑なユース・ケース・パターンで複数のアプリケーション間でファイルを転送することによって、それらの統合を実現します。この項では、一般的なユース・ケース・パターンについて説明します。

Oracle Managed File Transferを他のアプリケーションと統合する詳細な方法は、「Oracle Managed File Transferと他の製品の統合」を参照してください。

1.3.1 スタンドアロン・アプリケーション

図1-1は、Oracle Managed File Transferがそのローカル・ファイルを、埋込みFTPサーバー、埋込みsFTPサーバーおよびアクセス可能なファイル・システムを使用して転送する方法を示します。

図1-1 スタンドアロン・ユース・ケース・パターン

1回のファイル転送で1つ以上のターゲットを指定できます。複数ターゲットのユース・ケース・パターンをファンアウトと呼びます。ある転送のターゲットのエンドポイントを別の転送のソースとして使用して、チェーンを作成することもできます。

1.3.2 SOA統合

図1-2は、Oracle Managed File TransferをSOAアプリケーションのWebサービス・インタフェースと統合する方法を示します。

図1-2 SOAユース・ケース・パターン

SOAアプリケーションは、転送のソースとターゲットのどちらにも使用できます。また、SOAアプリケーションを、ある転送のターゲットと別の転送のソースで共通のエンドポイントとして使用することもできます。

1.3.3 B2B統合

図1-3は、Oracle Managed File TransferをB2B取引パートナと統合する方法を示します。

図1-3 B2Bユース・ケース・パターン

B2Bアプリケーションは、転送のソースとターゲットのどちらにも使用できます。また、B2Bアプリケーションを、ある転送のターゲットと別の転送のソースで共通のエンドポイントとして使用することもできます。

1.3.4 Healthcare統合

図1-4は、Oracle Managed File TransferをHealthcareエンドポイントと統合する方法を示します。

図1-4 Healthcareユース・ケース・パターン

Healthcareアプリケーションは、転送のソースとターゲットのどちらにも使用できます。また、Healthcareアプリケーションを、ある転送のターゲットと別の転送のソースで共通のエンドポイントとして使用することもできます。

1.3.5 Oracle Service Bus統合

図1-5は、Oracle Managed File TransferをOracle Service BusのWebサービス・インタフェースと統合する方法を示します。

図1-5 Oracle Service Busユース・ケース・パターン

Oracle Service Busインタフェースは、転送のソースとターゲットのどちらにも使用できます。また、Oracle Service Busインタフェースを、ある転送のターゲットと別の転送のソースで共通のエンドポイントとして使用することもできます。

1.3.6 ハイブリッド統合

図1-6は、Oracle Managed File Transferを複数のアプリケーションと統合する方法を示します。

図1-6 ハイブリッド・ユース・ケース・パターン

Oracle Managed File Transferは、複数のアプリケーション・タイプで構成されるデータ転送ネットワークの参加者として使用できます。

1.4 Oracle Managed File Transferのアーキテクチャ

図1-7は、Oracle Managed File Transferの主要コンポーネントを示します。構成データ、ユーザー・インタフェース・コンソール、埋込みFTPサーバーと埋込みsFTPサーバー、セキュリティ、および様々なタイプのファイル転送エンドポイントに対するインタフェースなどがあります。Oracle Managed File Transferは、高可用性を提供する複数の管理対象サーバーで構成できます。

図1-7 Oracle Managed File Transferのアーキテクチャ

コンソールの詳細は、「Oracle Managed File Transferの画面移動」を参照してください。他のコンポーネントの詳細は、「Oracle Managed File Transferのコンポーネント」を参照してください。

1.5 Oracle Managed File Transferのコンポーネント

この項では、図1-7のOracle Managed File Transferの各コンポーネントの詳細について説明します。

1.5.1 アーティファクト: ソース、ターゲットおよび転送

Oracle Managed File Transferコンソールの「デザイナ」ページでファイル配信構造を作成する際、次の3つのタイプのアーティファクトを作成します。

- ソース。ファイルの送信元を定義します。

- ターゲット。ファイルの宛先を定義します。

- 転送。1つのソースを1つ以上のターゲットに関連付けます。

アーティファクトは、ファイル配信構造の様々な部分の構成を定義します。これとは異なり、この構造に従う個々のファイル転送は、ファイル配信インスタンスです。

ソースとターゲットは、複数の転送で再使用できます。複数の転送で1つのソースを使用することは、転送ファンアウトと呼びます。1つの転送で複数のターゲットを使用することは、ターゲット・ファンアウトと呼びます。1つのソースとそれに関連付けられているすべての転送とターゲットをまとめてフローと呼びます。

アーティファクトの様々なプロパティを使用して、次に示すファイル配信動作を詳細に定義できます。

- フィルタ: 名前と拡張子が特定のパターンに一致するファイルを対象にしたり、除外したりできます。

- スケジュール: 転送を特定の時刻または時間枠に制限できます。

- 前処理アクション: ファイルを圧縮、圧縮解除、暗号化または復号化できます。

- 後処理アクション: ファイルを圧縮解除できます。

- ファイル操作: ファイルをアーカイブ、名前変更、移動または削除できます。

アーティファクトの作成の詳細は、「アーティファクト(転送、ソースおよびターゲット)の設計」を参照してください。

1.5.2 埋込みFTPサーバーと埋込みsFTPサーバー

Oracle Managed File Transferには、FTPとsFTPの2つのサーバーが埋め込まれています。これらの2つの埋込みサーバーをソース・アーティファクトとして使用できます。ポート、セキュリティ、およびディレクトリへのユーザー・アクセスなど、埋込みサーバーの様々なプロパティを構成できます。これらのサーバーは、WebLogic Server Oracle Managed File Transferのデプロイメントの過程で自動的にデプロイされます。詳細は、「Oracle Managed File Transfer埋込みサーバーの管理」を参照してください。

1.5.3 監視とレポート

Oracle Managed File Transferの監視ダッシュボードには、次に示す様々なツールが用意されています。

- メトリック: 転送ステータスのリアルタイム表示。失敗率、ペイロード・ファイル・サイズ、転送スピード、転送合計時間などが表示されます。

- ファイル・ファインダ: 検索タイプに基づいてソース・インスタンスまたはターゲット・インスタンスのどちらかが表示される表。

- 最新のエラー: 転送中に発生したエラーが表示される検索機能付きの表。

- アクティブな配信: 進行中および最近完了したファイル配信が表示される表。

- レポート: ソース、転送またはターゲットのそれぞれの観点による、個々のファイル配信の詳細情報。

詳細は、「Oracle Managed File Transferの監視」を参照してください。

1.5.4 セキュリティ

Oracle Managed File Transferのセキュリティは、次の方法で提供します。

- Oracle Managed File Transferコンソールへのユーザー・アクセスの制限

- 埋込みFTPサーバーと埋込みsFTPサーバーのディレクトリへのユーザー・アクセスの制限

- 特定の転送インスタンス内のファイルへのユーザー・アクセスの制限

- Webサービス・ソース・タイプに応じたHTTPエンドポイント・アクセスの保護

- キーベースの認証

- FTP over SSLおよびsFTPによるトランスポート

- ファイルの暗号化

詳細は、「Oracle Managed File Transferのセキュリティ」を参照してください。

1.5.5 ユーティリティ

Oracle Managed File Transferの機能の多くは、付属のWLSTコマンド行ユーティリティで実行できます。次のコマンド・カテゴリがあります。

- アーティファクト管理

- メタデータ管理

- キー管理

- デプロイメント履歴表示

- 転送管理

- 埋込みサーバー管理

- コールアウト管理

- イベント通知管理

- ランタイム・インスタンスと転送されたファイルのアーカイブ

- ランタイム・インスタンスと転送されたファイルのパージ

詳細は、「Oracle Managed File Transferのユーティリティ」を参照してください。

1.5.6 リポジトリ

Oracle Managed File Transferの構成データは、Oracle Metadata Repositoryに格納されます。この構成データを編集、バックアップおよび復元できます。詳細は、「Oracle Managed File Transferの管理」を参照してください。

1.5.7 インタフェース

Oracle Managed File Transferは、次に示す様々な標準インタフェースを使用して、ソースおよびターゲットのエンドポイント・タイプと通信します。

- FTP/SSH: FTPサーバー、sFTPサーバーおよびファイル・システムに対するインタフェース

- Webサービス: SOAP、SOA、Oracle Service BusおよびODIに対するインタフェース

- B2B: B2BおよびHealthcareに対するインタフェース

1.6 Oracle Managed File Transferのユーザー・ロール

Oracle Managed File Transferには、ファイル・ハンドラ、デザイナ、モニターおよび管理者の4つのユーザー・ロールがあります。これらのロールのユーザーの作成方法の詳細は、「ユーザーの認証および認可」を参照してください。

1.6.1 ファイル・ハンドラ

ファイル・ハンドラは、次のタスクを実行します。

- ファイルをファイル転送ステージング領域(ソース)にコピーします。

- ファイルをファイル転送宛先(ターゲット)から取得します。

ファイル・ハンドラには、Oracle Managed File Transferに直接アクセスする権限はありません。ソースとターゲットのディレクトリとエンドポイントにアクセスするために必要な権限を持っています。

1.6.2 デザイナ

デザイナは、次のタスクを実行します。

- ファイル転送ソースの作成、読取り、更新および削除を実行します。

- ファイル転送ターゲットの作成、読取り、更新および削除を実行します。

- 転送の作成、読取り、更新および削除を実行します。完成したファイル配信フローでは、転送によってソースとターゲットがリンクされます。

- 転送をデプロイおよびテストします。

1.6.3 モニター

モニタは、次のタスクを実行します。

- ダッシュボードとレポートを使用して、転送インスタンスが正常終了することを確認します。

- 長時間にわたる転送の一時停止と再開を実行します。

- エラーをトラブルシューティングして転送を再送信します。

- アーティファクトのデプロイメントと履歴を表示します。

- アーティファクトの依存関係を表示します。

- ソース、ターゲットおよび転送を有効化および無効化します。

- ソース、ターゲットおよび転送をアンデプロイします。

- 埋込みFTPサーバーと埋込みsFTPサーバーの起動と停止を実行します。

1.6.4 管理者

管理者は次のタスクを実行します。

- ファイル・ハンドラのすべてのタスク

- デザイナのすべてのタスク

- モニターのすべてのタスク

- 他のユーザーの追加とそのロールの決定

- ユーザー・ディレクトリ権限の構成

- Oracle Managed File Transferサーバーの構成

- 埋込みFTPサーバーと埋込みsFTPサーバーの構成(セキュリティを含む)

- B2BとHealthcareのドメインの構成

- Oracle Managed File Transfer構成のバックアップと復元

- 転送されたファイルとインスタンス・データのパージ

- インスタンス・データとペイロードのアーカイブと復元

- メタデータのインポートとエクスポート

1.7 Oracle Managed File Transferのインストール

Oracle Managed File Transferは、単独でインストールすることも、Oracle WebLogic Serverドメイン内にOracle SOA Suiteとしてインストールすることもできます。詳細は、『Oracle Managed File Transferのインストールと構成』のOracle Managed File Transferインストールおよび構成の準備に関する項を参照してください。

サポート対象システム構成は、Oracle Technology Network Webサイト(http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html)を参照してください。

1.8 Oracle Managed File Transferの画面移動

Oracle Managed File Transferコンソールでは、特定のタスクに集中できるように、領域を開く、閉じる、非表示にするなどの操作が可能です。この項では、コンソールの基本操作について説明します。

1.8.1 「設計」、「監視」および「管理」の各ページ

コンソールのトップ・バナーの中央に、トップレベル・ページへのリンクがあります。これらのどのページにアクセスできるかは、ユーザー・ロールによって異なります。詳細は、「Oracle Managed File Transferのユーザー・ロール」を参照してください。トップレベル・ページの内容は、次のとおりです。

- デザイナ: このページを使用して、ソース、ターゲットおよび転送を作成、変更、削除、名前変更およびデプロイします。

- 監視: このページを使用して、転送の統計、進行状況およびエラーを監視します。また、転送デプロイメントを無効化、有効化およびアンデプロイしたり、インスタンスを一時停止、再開および再送信したりできます。

- 管理: このページを使用して、埋込みサーバー構成などのOracle Managed File Transfer構成を管理します。

図1-8 「設計」、「監視」および「管理」の各ページ

1.8.2 左側のパネルのナビゲータの使用

各トップレベル・ページの左側のパネルのナビゲーション・ツリーには、実行できるタスクが表示されており、そのほとんどはタブが開きます。名前の左側に右矢印がある場合、サブタスクが隠されていることを示します。この矢印をクリックすると、矢印が右下を向いて、サブタスクが表示されます。

たとえば、「デザイナ」ページには、「転送」、「ソース」および「ターゲット」の3つの主要タスクがあります。「転送」の左にある矢印は、少なくとも1つの転送が作成されていることを示します。「ソース」と「ターゲット」の場合も同様です。「転送」の横の矢印をクリックして、転送の名前を表示します。

図1-9 「デザイナ」ページの左側のパネルのナビゲータ

1.8.3 動的なタブの開閉

ナビゲーション・ツリーのタスクをタブで開くには、タスクをクリックします。タスクを選択して「開く」アイコンを選択する方法もあります。トップレベル・ページのそれぞれについて、最大15個のタブを同時に開くことができます。

図1-10 タブを開く

たとえば、「デザイナ」ページでは、新しいソースを作成するには、「ソース」をクリックします。「転送」と「ターゲット」の場合も同様です。既存のソース、転送またはターゲットを編集するには、その名前をクリックします。

アクティブなタブを閉じるには、トップ・バナーの右側にある「閉じる」アイコンをクリックします。アクティブなタブを除くすべてのタブを閉じるには、「閉じる」アイコンの右側のドロップダウン・メニューから「その他を閉じる」を選択します。すべてのタブを閉じるには、同じメニューから「すべて閉じる」を選択します。

図1-11 タブを閉じるオプション

1.8.4 ソースとターゲットの転送へのドラッグ・アンド・ドロップ

転送を作成してそのタブを開くと、「ソースの追加」オプションと「ターゲットの追加」が表示されます。1つのソース・アイコンと1つ以上のターゲット・アイコンを、それぞれターゲット・ページの該当する領域にドラッグ・アンド・ドロップできます。アイコンをドラッグ・アンド・ドロップする必要があります。名前をドラッグ・アンド・ドロップしても動作しません。

図1-12 ソース・アイコンをドラッグしてソースを追加する

1.8.5 ダッシュボードの領域の開閉

「監視」ページのメイン・タブでは、ダッシュボードが常に開かれています。ダッシュボードには、「メトリック」、「ファイル・ファインダ」、「最新のエラー」および「アクティブな配信」の4つの領域があります。各領域の右上隅に「開く」アイコンがあります。このアイコンをクリックすると、その領域がコンソール全体に拡大し、追加詳細が表示されます。ダッシュボードに戻るには、拡大されている領域の右上隅の「閉じる」アイコンをクリックします。

図1-13 「監視」領域の開閉

1.8.6 言語、タイムゾーンおよびアクセシビリティ・プリファレンスの設定

このプロセスの手順は次のとおりです。

1. Oracle Managed File Transferのトップ・バナーの右側にある「プリファレンス」をクリックします。

2. 「プリファレンス」ウィンドウの左側で、「言語」を選択します。

3. 「言語」ドロップダウン・リストから言語を選択します。

「プリファレンスなし」は、デフォルトで英語に設定されます。

注意:

言語の変更を有効にするには、ログアウトしてから再度ログインする必要があります。

4. 「タイムゾーン」ドロップダウン・リストからダッシュボードおよびアラートのタイムゾーンを選択します。

「プリファレンスなし」は、デフォルトで協定世界時(UTC)に設定されます。

5. 「プリファレンス」ウィンドウの左側で、「アクセシビリティ」を選択します。

ログイン画面の右上隅の「アクセシビリティ」をクリックして、アクセシビリティ設定を変更することもできます。

6. 「モード設定」ドロップダウン・リストからオプションを選択します。

- プリファレンスなし

- スクリーン・リーダー・モードの有効化

- スクリーン・リーダー・モードの無効化

「プリファレンスなし」は、デフォルトでスクリーン・リーダー・モードの無効化に設定されます。

7. 「コントラスト設定」ドロップダウン・リストからオプションを選択します。

- プリファレンスなし

- 高コントラストの使用

- 通常のコントラストの使用

「プリファレンスなし」は、デフォルトで通常のコントラストに設定されます。

8. 「フォント設定」ドロップダウン・リストからオプションを選択します。

- プリファレンスなし

- 大きいフォントの使用

- 通常フォントの使用

「プリファレンスなし」は、デフォルトで通常フォントに設定されます。

9. 「適用」をクリックし、「OK」をクリックします。

Oracle Managed File Transferを監視および管理するページのアクセシビリティ・オプションは、Oracle Enterprise Manager Fusion Middleware Controlによって提供されます。Fusion Middleware Controlは、スクリーン・リーダーをサポートしており、キーボード・ナビゲーションをサポートするための標準のショートカット・キーを提供しています。読みやすくするために、コンソール・ページを高コントラストで表示したり、大きなフォントで表示したりすることもできます。Fusion Middleware Controlにおけるアクセシビリティの構成の詳細と手順は、Oracle Fusion Middlewareの管理のOracle Fusion Middlewareのアクセシビリティ・オプションの使用を参照してください。

2 アーティファクト(転送、ソースおよびターゲット)の設計

この章では、Oracle Managed File Transferを使用して、ソース、ターゲットおよび転送で構成されるファイル配信構造を設計する方法について説明します。

この章の内容は次のとおりです。

- 転送の設計について

- 転送の構成

- ソースの作成

- ターゲットの作成

- スケジュールの設定

- 転送のデプロイとテスト

- 転送のインポートとエクスポート

2.1 転送の設計について

Oracle Managed File Transferコンソールで「設計」ページを使用してファイル転送を設計する前に、紙またはホワイトボードの上で転送を設計する必要があります。

2.1.1 転送を作成するための準備

転送は、1つのソースを1つ以上のターゲットとリンクするアーティファクトです。転送には、転送に影響を与えるコンテンツ・フィルタや他のアクションを追加できます。転送を作成する前に、転送で実行する必要がある内容の詳細を決定する必要があります。次の仕様について検討します。

- 送信元。ここからファイルを転送します。ソースと呼ばれます。

- 宛先。ここにファイルを転送します。ターゲットと呼ばれます。

- 送信元と宛先が、ファイル・システム・ディレクトリとWebサービス・エンドポイントURLのどちらであるか。送信元と宛先は、B2BやHealthcareなどの他のアプリケーションに存在することも可能です。

- ファイルのサイズが大きい場合、ファイルではなく、参照をWebサービス宛先に渡すことができます。

- 送信元と宛先のアクセス・パラメータ: ユーザー名、パスワード、セキュリティ証明書およびファイル・システム権限

- ファイル形式: バイナリ、XMLまたはテキスト

- 形式または名前に基づいて一部のファイルを追加または除外する必要があるかどうか。

- ファイルを圧縮または圧縮解除する必要があるかどうか。

- ファイルを暗号化または復号化する必要があるかどうか。

- ファイルを名前変更、移動、アーカイブまたは削除する必要があるかどうか。

- ファイル配信を特定の時刻または時間範囲にスケジュールする必要があるかどうか。

注意:

「アーティファクト検索」タブを使用して、変更を加えて再使用または再作成できるソース、ターゲットまたは転送が存在するかどうかを確認できます。詳細は、Oracle Fusion Middleware MFTオンライン・ヘルプのアーティファクト検索に関する項を参照してください。

2.1.2 エンドツーエンド・フローの設計

ソースとターゲットは、複数の転送で再使用できます。複数の転送で1つのソースを使用することは、転送ファンアウトと呼びます。1つの転送で複数のターゲットを使用することは、ターゲット・ファンアウトと呼びます。1つのソースとそれに関連付けられているすべての転送とターゲットをまとめてフローと呼びます。

ソースをターゲットとして使用することおよびターゲットをソースとして使用することはできません。ただし、ターゲットとソースが同じ場所を参照することはできます。したがって、ある転送のターゲットを別の転送のソースにすることで、転送チェーンを作成できます。

各転送の仕様を決定することに加えて、全体的なファイル配信構造の中で必要なファンアウトとチェーンを綿密に計画する必要があります。「Oracle Managed File Transferの機能的なユース・ケース・パターン」の例を参照してください。

2.2 転送の構成

ターゲットの作成およびソースとターゲットの作成は、どちらが先でもかまいません。ただし、転送をデプロイするには、1つのソースと少なくとも1つのターゲットが必要です。

このプロセスの手順は次のとおりです。

1. 次のいずれかの方法で転送を作成します。

- 左側のペインのナビゲータで「転送」をクリックします。

- 左側のペインのナビゲータで「転送」を選択し、「作成」アイコンをクリックします。

- 左側のペインのナビゲータで「転送」を右クリックし、「作成」コマンドを選択します。

「転送」ダイアログが開きます。

2. 転送の名前を入力します。

名前には、英字、数字、ダッシュおよびアンダースコアを使用できます。

3. 転送の説明を入力します。

説明はオプションです。

4. 「OK」ボタンをクリックします。

転送のタブが開きます。

転送の作成を取り消すには、「取消」をクリックします。

5. ソースを1つとターゲットを1つ以上追加します。

「ソースとターゲットの追加」を参照してください。

6. コンテンツ・フィルタを追加します。

これはオプションです。「コンテンツ・フィルタの設定」を参照してください。

7. 転送ペイロードにアクセスできるユーザー、グループおよび役割を追加します。

これはオプションであり、Webサービスへの参照渡しによる転送にのみ適用されます。「ペイロード・アクセスの許可」を参照してください。

8. ターゲット固有の転送設定を構成します。

これはオプションです。「ターゲット固有の転送設定の構成」を参照してください。

9. スケジュールを追加します。

これはオプションです。「スケジュールの設定」を参照してください。

10. 圧縮や暗号化などの前処理と後処理のアクションを追加します。

これはオプションであり、ターゲットにのみ適用されます。ソース・アクションは、ソース・アーティファクトで直接追加します。「転送の前処理と後処理のアクションの設定」を参照してください。

11. 「保存」ボタンをクリックします。

最後に保存した後のすべての変更を元に戻すには、「元に戻す」をクリックします。

12. 保存した後、「デプロイ」ボタンをクリックします。

オプションのコメントを追加できます。

転送をデプロイする際、関連付けられているソースとターゲットがまだデプロイされていない場合は、それらが自動的にデプロイされます。

必要なプロパティのほとんどが設定されている転送が既存の場合は、それを複製して使用できます。「既存の転送の複製」を参照してください。

2.2.1 ソースとターゲットの追加

このプロセスの手順は次のとおりです。

1. 左側のペインのナビゲータで「転送」の左にある矢印をクリックします。

転送がリストされます。このステップは、前のステップで転送を作成したときに完了している可能性があることに注意してください。

2. 転送名をクリックするか、転送名を右クリックして「開く」メニュー・アイテムを選択します。

その転送のタブが開きます。

3. 次のいずれかの方法でソースを追加します。

- 作成済のソースが存在する場合は「ソースの追加」をクリックします。追加するソースを選択し、「OK」をクリックします。

- 「ソースの作成」をクリックして、新しいソースを作成します。「ソースの作成」のステップ2から開始します。

- ナビゲーション・ペインからソースをドラッグ・アンド・ドロップします。
詳細は、「ソースとターゲットの転送へのドラッグ・アンド・ドロップ」を参照してください。

4. 次のいずれかの方法でターゲットを追加します。

- 作成済のターゲットが存在する場合は「ターゲットの追加」をクリックします。
左側の列で追加するターゲットを選択して一重矢印アイコンをクリックし、右側の列に移動します。複数のターゲットを追加できます。すべてのターゲットを選択するには、二重矢印アイコンをクリックします。「OK」をクリックします。

- 「ターゲットの作成」をクリックして、新しいターゲットを作成します。「ターゲットの作成」のステップ2から開始します。

- ナビゲーション・ペインからターゲットをドラッグ・アンド・ドロップします。
詳細は、「ソースとターゲットの転送へのドラッグ・アンド・ドロップ」を参照してください。

5. 転送を保存してデプロイします。

2.2.2 コンテンツ・フィルタの設定

コンテンツ・フィルタは、転送に適用するファイル名と拡張子のパターン条件を指定します。コンテンツ・フィルタが定義されていない場合、ソース・エンドポイントのすべてのファイルが転送されます。

このプロセスの手順は次のとおりです。

1. 左側のペインのナビゲータで「転送」の左にある矢印をクリックします。

転送がリストされます。

2. 転送名をクリックするか、転送名を右クリックして「開く」アイコンをクリックします。

その転送のタブが開きます。

3. コンテンツ・フィルタの左にある矢印をクリックします。

コンテンツ・フィルタ設定が表示されます。

4. 「ワイルドカード」または「正規表現」を選択し、フィルタ文字列の解釈方法を指定します。

5. フィルタのテキスト・フィールドにパターンを入力します。

「ワイルドカード」を選択した場合は、*をワイルドカードとして使用します。たとえば、*.xmlと指定するとXMLファイルが転送されます。テキストまたはXMLファイルを指定するには、*.(xml|XML|txt|TXT)を使用できます。たとえば「File = "TXT-20100505-XXXX.txt"」。ここで、XXXXは任意の4つの連続する数字です。Regexp Filter expression ="XT-20100505-\\d{4}\\.txt"。

正規表現の詳細は、Javaチュートリアル: 正規表現を参照してください。

パターンは、ファイル名のみに適用されます。ディレクトリ名でのフィルタ処理はサポートされていません。

6. 「フィルタの追加」をクリックして、フィルタをもう1つ追加します。

テキスト・フィールドが作成され、新しい番号が付きます。

7. 追加するフィルタごとに、ステップ5と6を繰り返します。

フィルタを削除するには、フィルタの右側の赤いXをクリックします。

8. 各フィルタの右側にある上矢印および下矢印を使用して、フィルタ順序を変更します。

番号の小さなフィルタが先に実行されます。

9. 転送を保存してデプロイします。

2.2.3 ターゲット固有の転送設定の構成

転送タブを開いてターゲットの左側にある矢印をクリックすると、ターゲット・タイプに応じて異なるターゲット固有のオプションの転送設定が表示されます。

ターゲット・タイプが「ファイル」、「FTPリモート」または「sFTPリモート」である場合、サブフォルダ設定が表示されます。これにより、転送固有のサブフォルダがターゲットの場所に追加されます。

ターゲット・タイプがHTTP SOAベースのWebサービス・タイプ(「B2B」、「Healthcare」、「SOAP」、「SOA」、「Service Bus」または「ODI」)である場合、次の「配信プリファレンス」が表示されます。

- 配信方法: 配信方法として、「インライン」または「参照」(デフォルト)を指定します。「インライン」の場合、実際のファイルはSOAメッセージ・ペイロードで送信されます。「参照」の場合は、ファイルへのリンクが送信されます。

- 参照タイプ: 参照タイプとして、「FTP」(デフォルト)、「ファイル」または「sFTP」を指定します。内部ポート番号と外部ポート番号を、「管理サーバーのプロパティ」ページの「拡張配信プロパティ」領域で設定できます。

- 最大インライン・サイズ(バイト): インライン配信の最大サイズをバイト単位で指定します。

2.2.4 転送の前処理と後処理のアクションの設定

転送にターゲットを追加した後、その転送を編集して、圧縮、圧縮解除(ファイル・タイプのみ)、暗号化または復号化を前処理アクションとして追加できます。圧縮解除は、ファイル・タイプのターゲットの後処理アクションとしても追加できます。

ソースの前処理を構成できます。「ソース処理アクションの設定」を参照してください。

前処理と後処理のカスタム・アクションも作成できます。「カスタム・コールアウトによる転送の処理」を参照してください。

注意:

後処理は、ファイル配信の後に実行されます。したがって、配信が成功して後処理が失敗した場合、「監視」ページの「ダッシュボード」タブの「アクティブな配信」ビューと「ファイル・ファインダ」ビューに表示されるステータスは異なります。具体的には、「アクティブな配信」ビューでは「完了」ステータスが表示されますが、「ファイル・ファインダ」ビューでは「失敗」ステータスが表示されます。

注意:

ソースとそのソースを使用するターゲットに同じ処理アクションを追加すると、そのアクションが2回実行されます。たとえば、ソースとターゲットに圧縮を追加すると、転送するファイルが2回圧縮されます。

複数ファイルの前処理の圧縮解除は、ターゲット・タイプがSOAP、SOA、Service BusおよびODIの場合にのみサポートされます。その他のターゲット・タイプでは、圧縮ファイルに複数のエントリがある場合には、前処理の圧縮解除エラーが発生します。

注意:

Oracle Managed File Transferの外部でFTPクライアントを使用してバイナリ・ファイルをソースの場所にコピーする際は、バイナリ転送として構成する必要があります。そうしないと、ファイルが破損する可能性があります。圧縮や暗号化などの処理アクションは正常に動作しない可能性があります。

2.2.4.1 前処理での圧縮および圧縮解除アクション

転送でファイルをターゲットに配信する前に、ファイルを圧縮または圧縮解除できます。どちらのアクションも、転送構成で指定できます。

前処理での複数ファイルの圧縮解除は、「配信方法」が「参照」に設定されている、SOAP、SOA、Service BusおよびODIの各タイプのターゲットでのみサポートされます。この場合、ZIPファイル内のファイルは一意のランダムなディレクトリに抽出され、このディレクトリへの参照のみがターゲットに送信されます。このディレクトリは、ターゲット・レポートの「ターゲット前処理」セクションにリストされます。詳細は、「ターゲット・レポート」を参照してください。

注意:

複数ファイルの圧縮解除の後に追加されている処理関数は無視されます。他のタイプのターゲットを前処理で圧縮解除して複数ファイルが生成される場合、圧縮解除アクションでエラーが発生します。

このプロセスの手順は次のとおりです。

1. 左側のペインのナビゲータで「転送」の左にある矢印をクリックします。

転送がリストされます。

2. 転送名をクリックするか、転送名を右クリックして「開く」メニュー・アイテムを選択します。

その転送のタブが開きます。

3. ターゲットの左にある矢印をクリックします。

ターゲット設定が表示されます。

4. 「前処理アクションの追加」をクリックします。

「前処理アクション」ダイアログが開きます。

5. 「すべてのアクション」ドロップダウン・リストから「圧縮」または「圧縮解除」を選択します。

6. 「リストに追加」をクリックします。

リストからアクションを削除するには、アクションの右にある「削除」アイコンをクリックします。

7. 「圧縮」を選択している場合、「レベル」ドロップダウン・リストの「ベスト圧縮」、「デフォルト圧縮」または「ベスト・スピード」から圧縮レベルを選択します。詳細は、java.util.zipパッケージ、特にDeflaterクラスおよび参照仕様を参照してください。

8. 「OK」をクリックします。

アクションの追加を取り消すには、「取消」をクリックします。

9. 転送を保存してデプロイします。

2.2.4.2 前処理での暗号化および復号化アクション

転送する前に、ファイルを暗号化または復号化できます。どちらのアクションも、転送構成で指定できます。

注意:

暗号化アクションまたは復号化アクションを追加する前に、PGPキーストアを構成し、証明書をインポートする必要があります。

制限されている鍵の長さまたはアルゴリズムを使用してMFTの外部でPGPツールによってペイロードが暗号化されている場合、MFTでの復号化は失敗します。このような制限のほとんどは、JAVA_HOME\jre7\lib\securityディレクトリでJREレベルで指定されています。

このプロセスの手順は次のとおりです。

1. 左側のペインのナビゲータで「転送」の左にある矢印をクリックします。

転送がリストされます。

2. 転送名をクリックするか、転送名を右クリックして「開く」メニュー・アイテムを選択します。

その転送のタブが開きます。

3. ターゲットの左にある矢印をクリックします。

ターゲット設定が表示されます。

4. 「前処理アクションの追加」をクリックします。

「前処理アクション」ダイアログが開きます。

5. 「すべてのアクション」ドロップダウン・リストから「PGP暗号化」または「PGP復号化」を選択します。

6. 「リストに追加」をクリックします。

リストからアクションを削除するには、アクションの右にある「削除」アイコンをクリックします。

7. 「PGP暗号化」を選択している場合、「暗号化の別名」と「防御済」の各ドロップダウン・リストから値を選択します。

- 暗号化の別名: 暗号化の公開鍵の別名。鍵の別名の詳細は、「PGPキーストアの構成」を参照してください。

- 防御済: 「バイナリ」または「ASCII」。印刷できない文字が転送中に削除される可能性がある場合は、ASCIIを使用します。

8. 「PGP復号化」を選択している場合、「復号化別名」ドロップダウン・リストから復号化別名を選択します。これは、復号化に使用する秘密鍵の別名です。鍵の別名の詳細は、「PGPキーストアの構成」を参照してください。

9. 「OK」をクリックします。

アクションの追加を取り消すには、「取消」をクリックします。

10. 転送を保存してデプロイします。

2.2.4.2.1 PGP用の暗号化アルゴリズムの変更

PGPの暗号化アルゴリズムを変更するには、次の手順を実行します。

1. 手順 A

a. Oracle Enterprise Manager Fusion Middleware Controlにログインします。

b. SOAノードを展開し、soa-infraノードを選択します。

c. 「SOAインフラストラクチャ」メニューから、「管理」→「システムMBeanブラウザ」の順に選択します。「システムMBeanブラウザ」ページが表示されます。

d. 「アプリケーション定義のMBean」の下で、サーバー - 「oracle.as.soainfra.config」ノードを開きます。たとえば、「oracle.as.mftinfra.config node」です。

e. サーバー: 「soa_server1」ノードを開きます。たとえば、「mft_server1」ノードです。

f. 「MFTConfig」ノードを展開します。

g. MFT MBeanをクリックします。MBeanのプロパティが右側のペインに表示されます。

h. 「操作」タブをクリックします。

i. リストでaddProperty 操作をクリックします。キー、値、および必要に応じてコメントを入力します。
i. 「pgpEncryptionAlgorithm」に「キー」値を設定します

ii. 値を設定します。たとえば、「Triple DES」を値「2」に設定し、「呼出し」をクリックします。

2. 手順 B

a. MFTで、PGPの暗号化アルゴリズムを変更するには、MFTに「pgpEncryptionAlgorithm」MBeanを設定します。このMbeanは整数値を受け入れ、次にリストされているサポートされたアルゴリズムの様々な値を受け入れます。

i. Triple DES = 2;

ii. CAST5 = 3;

iii. Blowfish = 4;

iv. DES = 6;

v. AES 128 = 7;

vi. AES 192 = 8;

vii. AES 256 = 9;

viii. Twofish = 10;

b. FIPSモードでは、MBeanプロパティPGPEncryptionAlgorithmが定義されていない場合、デフォルト・アルゴリズムはAES 256です。サポートされているアルゴリズムは次のとおりです。

i.AES 128

ii.AES 192

iii.AES 256

c. 非FIPSモードでは、MBeanプロパティPGPEncryptionAlgorithmが定義されていない場合、デフォルト・アルゴリズムはCAST5です。サポートされているアルゴリズムは次のとおりです。

i. Triple DES

ii. Blowfish

iii. DES

iv. AES 192

v. AES 128

vi. AES 256

vii.Twofish

2.2.4.3 後処理での圧縮解除

ターゲット・タイプがファイルの場合のみ、転送の後に、ファイルを圧縮解除できます。このアクションは、転送構成で指定できます。

後処理での複数ファイルの圧縮解除はサポートされています。この場合、圧縮解除されたファイルは、ターゲットの場所の下のZIPファイルと同じ名前(拡張子なし)のディレクトリに抽出されます。たとえば、ターゲットの場所が/tmp/mft、複数エントリを持つ転送されたファイルの名前がorder.zipである場合、圧縮解除されたファイルは/tmp/mft/orderに抽出されます。

注意:

複数ファイルの圧縮解除の後に追加されている処理関数は無視されます。

このプロセスの手順は次のとおりです。

1. 左側のペインのナビゲータで「転送」の左にある矢印をクリックします。

転送がリストされます。

2. 転送名をクリックするか、転送名を右クリックして「開く」メニュー・アイテムを選択します。

その転送のタブが開きます。

3. ターゲットの左にある矢印をクリックします。

ターゲット設定が表示されます。

4. 「後処理アクションの追加」をクリックします。

「後処理アクション」ダイアログが開きます。

5. 「すべてのアクション」ドロップダウン・リストから「圧縮解除」を選択します。

6. 「リストに追加」をクリックします。

リストからアクションを削除するには、アクションの右にある「削除」アイコンをクリックします。

7. 「OK」をクリックします。

アクションの追加を取り消すには、「取消」をクリックします。

8. 転送を保存してデプロイします。

2.2.5 既存の転送の複製

既存のファイル転送をコピーして、新しいファイル転送を作成できます。新しい転送は、コピー元の転送と同じソースおよびターゲットを参照します。

このプロセスの手順は次のとおりです。

1. 次のどちらかの方法で転送を複製します。

- コピーする転送を選択し、左側のペインのナビゲータで「複製」アイコンを選択します。

- 左側のペインのナビゲータでコピーする転送を右クリックし、ポップアップ・メニューから「複製」コマンドを選択します。

「転送の複製」ダイアログが表示されます。

2. 転送の名前を入力します。

名前には、英字、数字、ダッシュおよびアンダースコアを使用できます。

3. 「作成」ボタンをクリックします。

転送のタブが開き、編集可能な追加設定が表示されます。これらの設定の詳細は、次の項を参照してください。

- ソースとターゲットの追加

- コンテンツ・フィルタの設定

- ペイロード・アクセスの許可

- ターゲット固有の転送設定の構成

- スケジュールの設定

- 転送の前処理と後処理のアクションの設定

転送の作成を取り消すには、「取消」をクリックします。

4. 編集した後、「保存」ボタンをクリックします。

最後に保存した後のすべての変更を元に戻すには、「元に戻す」をクリックします。

5. 保存した後、「デプロイ」ボタンをクリックします。

転送をデプロイする際、関連付けられているソースとターゲットが自動的にデプロイされます。

2.3 ソースの作成

最小限の設定でソースを作成できます。作成した後は、編集してさらに設定を追加できます。

このプロセスの手順は次のとおりです。

1. 次のいずれかの方法でソースを作成します。

- 転送タブで「ソースの作成」をクリックします。

- 左側のペインのナビゲータで「ソース」をダブルクリックします。

- 左側のペインのナビゲータで「ソース」を選択し、「作成」アイコンをクリックします。

- 左側のペインのナビゲータで「ソース」を右クリックし、「作成」コマンドを選択します。

- 既存のソースを複製します。

「ソース」ダイアログが開きます。

2. ソースの名前を入力します。

名前には、英字、数字、ダッシュおよびアンダースコアを使用できます。

注意:
SOA/SOAPソースの場合、ファイル名にスペースを含めることはできません。

3. ソースの摘要を入力します。

説明はオプションです。

4. ソースのタイプを選択します。

この設定により、表示される他の設定が決まります。ソース・タイプとその設定の詳細は、「ソース・タイプ」を参照してください。

5. ソースの場所の値を入力します。ほとんどのソース・タイプでは、次のどちらかになります。

- 「フォルダ」設定。ファイル・システム・ディレクトリを指定します。フォルダ名が60文字を超えていないことを確認します。

- 「URL」設定。Webサービス・エンドポイントを指定します。

ソース・タイプが「B2B」と「Healthcare」である場合、「ソース」ダイアログにソースの場所の設定はありません。ソースの場所は、ソースを作成した後に設定する必要があります。

6. 必須設定の値を入力します。必須設定は、横に青のアスタリスクが表示されます。

ソースの場所のほかに必須設定があるのは、FTPリモート・ソース・タイプとsFTPリモート・ソース・タイプのみです。これらの設定の一部はデフォルト値が存在し、一度受け入れて、後で編集できます。

7. 「OK」ボタンをクリックします。

ソースのタブが開き、編集可能な追加設定が表示されます。これらの設定の詳細は、「ソース・タイプ」、「スケジュールの設定」、「ソース処理アクションの設定」および「配信前のファイルのアーカイブと削除」のソース・タイプを参照してください。

ソースの作成を取り消すには、「取消」をクリックします。

8. 編集した後、「保存」ボタンをクリックします。

最後に保存した後のすべての変更を元に戻すには、「元に戻す」をクリックします。

9. 保存した後、「デプロイ」ボタンをクリックします。

オプションのコメントを追加できます。

このステップはオプションです。転送をデプロイする際、関連付けられているソースとターゲットが自動的にデプロイされます。

必要なプロパティのほとんどが設定されているソースが既存の場合は、それを複製して使用できます。「既存のソースの複製」を参照してください。

2.3.1 ソース・タイプ

Oracle Managed File Transferには、次のソース・タイプがあります。

- FTP埋込みソース・タイプ

- sFTP埋込みソース・タイプ

- FTPリモート・ソース・タイプ

- sFTPリモート・ソース・タイプ

- ファイル・ソース・タイプ

- SOAP Webサービス・ソース・タイプ

- SOAソース・タイプ

- Service Busソース・タイプ

- B2Bソース・タイプ

- Healthcareソース・タイプ

- ODIソース・タイプ

2.3.1.1 FTP埋込みソース・タイプ

FTP埋込みソース・タイプを使用することは、ファイルをOracle Managed File Transferに埋め込まれているFTPサーバーにアップロードして、Oracle Managed File Transferがそのファイルを転送することを意味します。唯一の必須設定である「フォルダ」は、ファイル転送元の埋込みFTPサーバー・ディレクトリを指定します。

注意:

ソースがデプロイおよび有効化される前から埋込みFTPソース・ディレクトリに存在するファイルは無視されます。デプロイまたは有効化の後にディレクトリにアップロードされたファイルのみが検出され、転送されます。

ソース作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース-FTP埋込みに関する項を参照してください。

2.3.1.2 sFTP埋込みソース・タイプ

sFTP埋込みソース・タイプを使用することは、ファイルをOracle Managed File Transferに埋め込まれているsFTPサーバーにアップロードして、Oracle Managed File Transferがそのファイルを転送することを意味します。唯一の必須設定である「フォルダ」は、ファイル転送元の埋込みsFTPサーバー・ディレクトリを指定します。

注意:

ソースがデプロイおよび有効化される前から埋込みsFTPソース・ディレクトリに存在するファイルは無視されます。デプロイまたは有効化の後にディレクトリにアップロードされたファイルのみが検出され、転送されます。

ソース作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース-sFTP埋込みに関する項を参照してください。

2.3.1.3 FTPリモート・ソース・タイプ

FTPリモート・ソース・タイプを使用することは、Oracle Managed File Transferの外部のFTPサーバーからファイルを転送することを意味します。表2-1に、「ソース」ダイアログのFTPリモート・タイプ固有の設定を示します。

表2-1 「ソース」ダイアログのFTPリモート・ソース・タイプの設定

設定

説明

ホスト名

ホスト名を指定します。

フォルダ

ファイルの転送元のディレクトリを指定します。

ユーザー

ソースにアクセスするユーザーを指定します。

パスワード

ユーザー・パスワードを指定します。

パスワードの確認

ユーザー・パスワードを確認します。

制御ポート

ソースのポートを指定します。

SSL

選択されている場合、SSLの使用を指定します。これはオプションです。

暗黙的SSL

選択されている場合、暗黙的SSLの使用を指定します。これはオプションです。

ソース作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース-FTPリモートに関する項を参照してください。

2.3.1.3.1 MVS転送のFTPリモート・ソース拡張プロパティ

MVSメインフレーム・システムのFTPリモート・ソース・タイプを作成する際には、拡張プロパティで「リスト・パーサー・キー」としてMVSを選択する必要があります。

MVS FTPレスポンス形式では、MVSはHFS(UNIXスタイル)レスポンスまたはMVSネイティブ・レスポンス形式を使用するよう構成できます。

MVS転送のFTPリモート・ソース設定

次の図で示すようにFTPリモート・ソース・タイプを構成します。

注意:次に示す形式では、次のプロパティを選択する必要があります。

- ディレクトリの変更=”true”

- 「コンテンツ・フォルダ」は必須で、「'FOLDER'」の形式にする必要があります。

- FTPパス・セパレータ = ””

- 絶対パス開始 = ””

- リスト・パーサー・キー = MVS

2.3.1.4 sFTPリモート・ソース・タイプ

sFTPリモート・ソース・タイプを使用することは、Oracle Managed File Transferの外部のsFTPサーバーからファイルを転送することを意味します。表2-2に、「ソース」ダイアログのsFTPリモート・タイプ固有の設定を示します。

表2-2 「ソース」ダイアログのsFTPリモート・ソース・タイプの設定

設定

説明

ホスト名

ホスト名を指定します。

フォルダ

ファイルの転送元のディレクトリを指定します。

ユーザー

ソースにアクセスするユーザーを指定します。

パスワード

ユーザー・パスワードを指定します。

注意:
MFTは、$で始まるプロパティをパラメータとして扱います。$で始まるsFTPパスワードについては、$の前にバックスラッシュ(または円記号)を追加してください。これが該当するのは、先頭の$についてのみです。それ以外の$がパスワードにあっても、そこにはバックスラッシュ(または円記号)を追加しないでください。例: $xyz$123の場合、パスワードは\$xyz$123と入力します。

パスワードの確認

ユーザー・パスワードを確認します。

制御ポート

ソースのポートを指定します。

認証タイプ

認証タイプとして、パスワードまたは公開鍵を指定します。

注意:
リモートSFTPサーバーの場合、秘密鍵パスフレーズはサポートされません。

ソース作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース-sFTPリモートに関する項を参照してください。

2.3.1.5 ファイル・ソース・タイプ

ファイル・ソース・タイプを使用することは、ローカル・ファイル・システムまたはネットワーク接続システムからファイルを転送することを意味します。唯一の必須設定である「フォルダ」は、ファイル転送元のディレクトリを指定します。このディレクトリは、Oracle Managed File Transferからアクセス可能である必要があります。

Oracle Managed File Transferは、Oracle SOA Suiteと同じファイル・アダプタを使用します。

ソース作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース-ファイルに関する項を参照してください。

2.3.1.6 SOAP Webサービス・ソース・タイプ

SOAP Webサービス・タイプを使用することは、Webサービス・エンドポイントからファイルを転送することを意味します。唯一の必須設定である「URL」は、ファイル転送元のWebサービス・エンドポイントを指定します。

WebサービスとしてOracle Managed File Transferと統合する場合の詳細は、「Webサービスとの統合」を参照してください。

ソース作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース-SOAPに関する項を参照してください。

2.3.1.7 SOAソース・タイプ

SOAソース・タイプを使用することは、SOAアプリケーションのWebサービス・インタフェースからファイルを転送することを意味します。唯一の必須設定は場所のURLで、SOAが使用するWebサービス・エンドポイントの接尾辞の部分を指定します。

例: http://<HOST:PORT/mftapp/services/transfer/<URL>?WSDL

Oracle Managed File TransferとOracle SOA Suiteの統合の詳細は、「Oracle SOA Suiteとの統合」を参照してください。

ソース作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース-SOAに関する項を参照してください。

2.3.1.8 Service Busソース・タイプ

Service Busソース・タイプを使用することは、Oracle Service BusアプリケーションのWebサービス・インタフェースからファイルを転送することを意味します。唯一の必須設定である「URL」は、ファイル転送元のWebサービス・エンドポイントを指定します。

Oracle Managed File TransferとOracle Service Busの統合の詳細は、「Oracle Service Busとの統合」を参照してください。

ソース作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース-Service Busに関する項を参照してください。

2.3.1.9 B2Bソース・タイプ

B2Bソース・タイプを使用することは、Oracle B2B取引パートナからファイルを転送することを意味します。B2Bが配置されている場合、必須設定はありません。最も重要な設定として、「取引パートナ名」および「ドメインの別名」があり、それぞれファイル転送元のエンドポイントおよびファイル転送元のドメインを指定します。

Oracle Managed File Transferで取引パートナを定義するには、「B2Bとの統合」と「ドメインの管理」を参照してください。

ソース作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース-B2Bに関する項を参照してください。

2.3.1.10 Healthcareソース・タイプ

Healthcareソース・タイプを使用することは、HealthcareドメインのOracle B2Bからファイルを転送することを意味します。唯一の必須設定である「エンドポイント名」は、ファイル転送元のエンドポイントを指定します。もう1つの重要な設定として「ドメインの別名」があり、ファイル取得元のドメインを指定します。

Oracle Managed File TransferでHealthcareドメインを定義するには、「Healthcareとの統合」と「ドメインの管理」を参照してください。

ソース作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース-Healthcareに関する項を参照してください。

2.3.1.11 ODIソース・タイプ

ODIソース・タイプを使用することは、Oracle Data IntegratorアプリケーションのWebサービス・インタフェースからファイルを転送することを意味します。唯一の必須設定である「URL」は、ファイル転送元のWebサービス・エンドポイントを指定します。

Oracle Managed File TransferでODIドメインを定義するには、「Oracle Data Integratorとの統合」と「ドメインの管理」を参照してください。

ソース作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース-ODIに関する項を参照してください。

2.3.2 ソース処理アクションの設定

ソースを作成した後、そのソースを編集して、圧縮、圧縮解除、暗号化または復号化などの処理アクションを追加できます。

転送の処理アクションを構成できます。「転送の前処理と後処理のアクションの設定」を参照してください。

前処理と後処理のカスタム・アクションも作成できます。「カスタム・コールアウトによる転送の処理」を参照してください。

注意:

ソースとそのソースを使用する転送に同じ処理アクションを追加すると、そのアクションが2回実行されます。たとえば、ソースと転送に圧縮を追加すると、転送するファイルが2回圧縮されます。

前処理の圧縮解除では、複数のエントリがある圧縮ファイルでエラーが発生します。

注意:

Oracle Managed File Transferの外部でFTPクライアントを使用してバイナリ・ファイルをソースの場所にコピーする際は、バイナリ転送として構成する必要があります。そうしないと、ファイルが破損する可能性があります。圧縮や暗号化などの処理アクションは正常に動作しない可能性があります。

2.3.2.1 ソースでの圧縮と圧縮解除

転送する前に、ファイルを圧縮または圧縮解除できます。どちらのアクションも、ソース構成で指定できます。

注意:

ソースでの複数ファイルの圧縮解除はサポートされていません。SOAP、SOA、Service BusまたはODIの各タイプのターゲットで前処理アクションとして、またはファイル・タイプのターゲットで後処理アクションとしてのみサポートされます。

このプロセスの手順は次のとおりです。

1. 左側のペインのナビゲータで「ソース」の左にある矢印をクリックします。

ソースがリストされます。

2. ソース名をクリックするか、ソース名を右クリックして「開く」メニュー・アイテムを選択します。

そのソースのタブが開きます。

3. 「アクション」の左にある矢印をクリックします。

「アクション」セクションが開きます。

4. 「処理アクションの追加」をクリックします。

「処理アクション」ダイアログが開きます。

5. 「すべてのアクション」ドロップダウン・リストから「圧縮」または「圧縮解除」を選択します。

6. 「リストに追加」をクリックします。

リストからアクションを削除するには、アクションの右にある「削除」アイコンをクリックします。

7. 「圧縮」を選択している場合、「レベル」ドロップダウン・リストの「ベスト圧縮」、「デフォルト圧縮」または「ベスト・スピード」から圧縮レベルを選択します。詳細は、java.util.zipパッケージ、特にDeflaterクラスおよび参照仕様を参照してください。

8. 「OK」をクリックします。

アクションの追加を取り消すには、「取消」をクリックします。

9. ソースを保存して、オプションでデプロイします。

2.3.2.2 ソースでの暗号化と復号化

転送する前に、ファイルを暗号化または復号化できます。どちらのアクションも、ソース構成で指定できます。1つの暗号化または復号化のアルゴリズムをソース構成に追加できます。

注意:

暗号化アクションまたは復号化アクションを追加する前に、PGPキーストアを構成し、証明書をインポートする必要があります。

制限されている鍵の長さまたはアルゴリズムを使用してMFTの外部でPGPツールによってペイロードが暗号化されている場合、MFTでの復号化は失敗します。このような制限のほとんどは、JAVA_HOME\jre7\lib\securityディレクトリでJREレベルで指定されています。

このプロセスの手順は次のとおりです。

1. 左側のペインのナビゲータで「ソース」の左にある矢印をクリックします。

ソースがリストされます。

2. ソース名をクリックするか、ソース名を右クリックして「開く」メニュー・アイテムを選択します。

そのソースのタブが開きます。

3. 「アクション」の左にある矢印をクリックします。

「アクション」セクションが開きます。

4. 「処理アクションの追加」をクリックします。

「処理アクション」ダイアログが開きます。

5. 「すべてのアクション」ドロップダウン・リストから「PGP暗号化」または「PGP復号化」を選択します。

6. 「リストに追加」をクリックします。

リストからアクションを削除するには、アクションの右にある「削除」アイコンをクリックします。

7. 「PGP暗号化」を選択している場合、「暗号化の別名」と「防御済」の各ドロップダウン・リストから値を選択します。

- 暗号化の別名: 暗号化の公開鍵の別名。鍵の別名の詳細は、「PGPキーストアの構成」を参照してください。

- 防御済: 「バイナリ」または「ASCII」。印刷できない文字が転送中に削除される可能性がある場合は、ASCIIを使用します。

8. 「PGP復号化」を選択している場合、「復号化別名」ドロップダウン・リストから復号化別名を選択します。これは、復号化に使用する秘密鍵の別名です。鍵の別名の詳細は、「PGPキーストアの構成」を参照してください。

9. 「OK」をクリックします。

アクションの追加を取り消すには、「取消」をクリックします。

10. ソースを保存して、オプションでデプロイします。

2.3.3 配信前のファイルのアーカイブと削除

ソースを作成した後、そのソースを編集して、アーカイブおよび削除をファイル操作として追加できます。ファイルをアーカイブするように構成している場合、そのファイルは指定された物理ターゲット・ディレクトリにコピーされます。ファイルを削除するように構成している場合、そのファイルは削除されます。アーカイブ・アクションまたは削除アクションは、ファイルのOracle Managed File Transferのコピーではなく、ターゲット・システムのコピーに適用されることに注意してください。

このプロセスの手順は次のとおりです。

1. 左側のペインのナビゲータで「ソース」の左にある矢印をクリックします。

ソースがリストされます。

2. ソース名をクリックするか、ソース名を右クリックして「開く」メニュー・アイテムを選択します。

そのソースのタブが開きます。

3. 「拡張プロパティ」の左にある矢印をクリックします。

「拡張プロパティ」セクションが開きます。

4. 「操作」サブタブをクリックします。

「操作」サブタブが開きます。

5. 「アクション・タイプ」ドロップダウン・リストから「アーカイブ」、「削除」または「アーカイブと削除」を選択します。

6. 「アーカイブ」または「アーカイブと削除」を選択した場合、「物理ターゲット・ディレクトリ」フィールドにパスを入力します。

7. ソースを保存して、オプションでデプロイします。

2.3.4 既存のソースの複製

既存のソースをコピーして、ファイル転送の新しいソースを作成できます。

このプロセスの手順は次のとおりです。

1. 次のどちらかの方法でソースを複製します。

- コピーするソースを選択し、左側のペインのナビゲータで「複製」アイコンを選択します。

- 左側のペインのナビゲータでコピーするソースを右クリックし、ポップアップ・メニューから「複製」コマンドを選択します。

「ソースの複製」ダイアログが表示されます。

2. ソースの名前を入力します。

名前には、英字、数字、ダッシュおよびアンダースコアを使用できます。

3. 複製されない必須設定の値を入力します。必須設定は、横に青のアスタリスクが表示されます。

- 「コンテンツ・フォルダ」は、ソースのタイプがファイル、FTPリモート、sFTPリモート、FTP埋込みまたはsFTP埋込みの場合に必須です。
「URL」は、ソースのタイプがSOAP、SOA、Service BusまたはODIの場合に必須です。

ソースのタイプがB2BまたはHealthcareの場合、複製されない必須設定はありません。

4. 「作成」ボタンをクリックします。

ソースのタブが開き、編集可能な追加設定が表示されます。これらの設定の詳細は、「ソース・タイプ」、「ソース処理アクションの設定」および「配信前のファイルのアーカイブと削除」のソース・タイプを参照してください。

ソースの作成を取り消すには、「取消」をクリックします。

5. 編集した後、「保存」ボタンをクリックします。

最後に保存した後のすべての変更を元に戻すには、「元に戻す」をクリックします。

6. 保存した後、「デプロイ」ボタンをクリックします。

このステップはオプションです。転送をデプロイする際、関連付けられているソースとターゲットが自動的にデプロイされます。

2.4 ターゲットの作成

最小限の設定でターゲットを作成できます。作成した後は、編集してさらに設定を追加できます。

このプロセスの手順は次のとおりです。

1. 次のいずれかの方法でターゲットを作成します。

- 転送タブで「ターゲットの作成」をクリックします。

- 左側のペインのナビゲータで「ターゲット」をダブルクリックします。

- 左側のペインのナビゲータで「ターゲット」を選択し、「作成」アイコンをクリックします。

- 左側のペインのナビゲータで「ターゲット」を右クリックし、「作成」コマンドを選択します。

「ターゲット」ダイアログが開きます。

2. ターゲットの名前を入力します。

名前には、英字、数字、ダッシュおよびアンダースコアを使用できます。

3. ターゲットの摘要を入力します。

説明はオプションです。

4. ターゲットのタイプを選択します。

この設定により、表示される他の設定が決まります。ターゲット・タイプとその設定の詳細は、「ターゲット・タイプ」を参照してください。

5. ターゲットの場所の値を入力します。ほとんどのターゲット・タイプでは、次のどちらかになります。

- 「フォルダ」設定。ファイル・システム・ディレクトリを指定します。フォルダ名が60文字を超えていないことを確認します。

- 「URL」設定。Webサービス・エンドポイントを指定します。

注意:
SOA/SOAPターゲットの場合、ファイル名にスペースを含めることはできません。

ターゲット・タイプが「B2B」と「Healthcare」である場合、「ターゲット」ダイアログにターゲットの場所の設定はありません。ターゲットの場所は、ターゲットを作成した後に設定する必要があります。

6. 必須設定の値を入力します。必須設定は、横に青のアスタリスクが表示されます。

ターゲットの場所のほかに必須設定があるのは、FTPリモート・ターゲット・タイプとsFTPリモート・ターゲット・タイプのみです。これらの設定の一部はデフォルト値が存在し、一度受け入れて、後で編集できます。

7. 「OK」ボタンをクリックします。

ターゲットのタブが開き、編集可能な追加設定が表示されます。これらの設定の詳細は、「ターゲット・タイプ」と「配信後のファイルの移動と名前変更」のターゲット・タイプを参照してください。

ターゲットの作成を取り消すには、「取消」をクリックします。

8. 編集した後、「保存」ボタンをクリックします。

最後に保存した後のすべての変更を元に戻すには、「元に戻す」をクリックします。

9. 保存した後、「デプロイ」ボタンをクリックします。

オプションのコメントを追加できます。

このステップはオプションです。転送をデプロイする際、関連付けられているソースとターゲットが自動的にデプロイされます。

必要なプロパティのほとんどが設定されているターゲットが既存の場合は、それを複製して使用できます。「既存のターゲットの複製」を参照してください。

2.4.1 ターゲット・タイプ

Oracle Managed File Transferには、次のターゲット・タイプがあります。

- FTPリモート・ターゲット・タイプ

- sFTPリモート・ターゲット・タイプ

- ファイル・ターゲット・タイプ

- SOAP Webサービス・ターゲット・タイプ

- SOAターゲット・タイプ

- Service Busターゲット・タイプ

- B2Bターゲット・タイプ

- Healthcareターゲット・タイプ

- ODIターゲット・タイプ

Oracle Managed File Transferは、埋込みFTPサーバー・ターゲットまたは埋込みsFTPサーバー・ターゲットをサポートしません。

2.4.1.1 FTPリモート・ターゲット・タイプ

FTPリモート・ターゲット・タイプを使用することは、Oracle Managed File Transferの外部のFTPサーバーにファイルを転送することを意味します。表2-3に、「ターゲット」ダイアログのFTPリモート・タイプ固有の設定を示します。

表2-3 「ターゲット」ダイアログのFTPリモート・ターゲット・タイプの設定

設定

説明

ホスト名

ホスト名を指定します。

フォルダ

ファイルの転送先のディレクトリを指定します。

ユーザー

ターゲットにアクセスするために使用するユーザーを指定します。

パスワード

ユーザー・パスワードを指定します。

パスワードの確認

ユーザー・パスワードを確認します。

制御ポート

ターゲットのポートを指定します。

SSL

選択されている場合、SSLの使用を指定します。これはオプションです。

暗黙的SSL

選択されている場合、暗黙的SSLの使用を指定します。これはオプションです。

ターゲット作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのターゲット-FTPリモートに関する項を参照してください。

2.4.1.1.1 MVS転送のFTPリモート・ターゲット設定

MVSメインフレーム・システムのFTPリモート・ターゲット・タイプを作成する際には、拡張プロパティで「リスト・パーサー・キー」としてMVSを選択する必要があります。

MVS FTPレスポンス形式では、MVSはHFS(UNIXスタイル)レスポンスまたはMVSネイティブ・レスポンス形式を使用するよう構成できます。ターゲット・タイプがMVS HFS (UNIXスタイル)を使用する場合、他のUNIXシステムと同じように拡張プロパティを構成できます。たとえば、パス・セパレータとしての「/」の使用です。ただし、MVSシステムがMVSネイティブ・レスポンス形式のみを使用する場合、FTPリモート・ターゲット・タイプを次の必須プロパティで構成する必要があります。

- 「コンテンツ・フォルダ」フィールドは使用されませんが、必須フィールドです。プレースホルダとしてなんらかのテキストを入力する必要があり、空白フィールドにしておくことはできません。たとえば、コンテンツ・フォルダ =”'FOLDER'”と入力します。

- 「FTPパス・セパレータ」フィールドは、空白にしておく必要があります。たとえば、FTPパス・セパレータ =””です。

- 「ファイル命名規則」フィールドでは、ファイルへの絶対パスを指定します。パスにはファイル名を含む必要があり、一重引用符で囲む必要があります。このフィールドは、ファイル命名規則=”MFTOUT.MFT%SEQ%.CSV”'の形式にする必要があります。たとえば、'QA.TEST.FILE 'です。

- デフォルトの日付書式を変更します。たとえば、yyyy/mm/ddです。

- 絶対パス開始 = ””

- リスト・パーサー・キー = MVS

次の図に示すように拡張プロパティを構成できます。

2.4.1.2 sFTPリモート・ターゲット・タイプ

sFTPリモート・ターゲット・タイプを使用することは、Oracle Managed File Transferの外部のsFTPサーバーにファイルを転送することを意味します。表2-4に、「ターゲット」ダイアログのsFTPリモート・タイプ固有の設定を示します。

表2-4 「ターゲット」ダイアログのsFTPリモート・ターゲット・タイプの設定

設定

説明

ホスト名

ホスト名を指定します。

フォルダ

ファイルの転送先のディレクトリを指定します。

ユーザー

ターゲットにアクセスするために使用するユーザーを指定します。

パスワード

ユーザー・パスワードを指定します。

パスワードの確認

ユーザー・パスワードを確認します。

制御ポート

ターゲットのポートを指定します。

認証タイプ

認証タイプとして、パスワードまたは公開鍵を指定します。

ターゲット作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのターゲット-sFTPリモートに関する項を参照してください。

2.4.1.3 ファイル・ターゲット・タイプ

ファイル・ターゲット・タイプを使用することは、ローカル・ファイル・システムまたはネットワーク接続システムにファイルを転送することを意味します。唯一の必須設定である「フォルダ」は、ファイル転送先のディレクトリを指定します。このディレクトリは、Oracle Managed File Transferからアクセス可能である必要があります。

Oracle Managed File Transferは、Oracle SOA Suiteと同じファイル・アダプタを使用します。

ターゲット作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのターゲット-ファイルに関する項を参照してください。

2.4.1.4 SOAP Webサービス・ターゲット・タイプ

SOAP Webサービス・タイプを使用することは、Webサービスにファイルを転送することを意味します。唯一の必須設定である「URL」は、ファイル転送先のWebサービス・エンドポイントを指定します。

WebサービスとしてOracle Managed File Transferと統合する場合の詳細は、「Webサービスとの統合」を参照してください。

ターゲット作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのターゲット-SOAPに関する項を参照してください。

2.4.1.5 SOAターゲット・タイプ

SOAターゲット・タイプを使用することは、SOAアプリケーションのWebサービス・インタフェースにファイルを転送することを意味します。唯一の必須設定である「URL」は、ファイル転送先のWebサービス・エンドポイントを指定します。

Oracle Managed File TransferとOracle SOA Suiteの統合の詳細は、「Oracle SOA Suiteとの統合」を参照してください。

ターゲット作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのターゲット-SOAに関する項を参照してください。

2.4.1.6 Service Busターゲット・タイプ

Service Busターゲット・タイプを使用することは、Oracle Service BusアプリケーションのWebサービス・インタフェースにファイルを転送することを意味します。唯一の必須設定である「URL」は、ファイル転送先のWebサービス・エンドポイントを指定します。

Oracle Managed File TransferとOracle Service Busの統合の詳細は、「Oracle Service Busとの統合」を参照してください。

ターゲット作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのターゲット-Service Busに関する項を参照してください。

2.4.1.7 B2Bターゲット・タイプ

B2Bターゲット・タイプを使用することは、Oracle B2B取引パートナにファイルを転送することを意味します。B2Bが配置されている場合、必須設定はありません。最も重要な設定として、「取引パートナ名」および「ドメインの別名」があり、それぞれファイル転送先のエンドポイントおよびファイル転送先のドメインを指定します。

Oracle Managed File Transferで取引パートナを定義するには、「B2Bとの統合」と「ドメインの管理」を参照してください。

ターゲット作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのターゲット-B2Bに関する項を参照してください。

2.4.1.8 Healthcareターゲット・タイプ

Healthcareターゲット・タイプを使用することは、HealthcareドメインのOracle B2Bにファイルを転送することを意味します。唯一の必須設定である「エンドポイント名」は、ファイル転送先のエンドポイントを指定します。もう1つの重要な設定として「ドメインの別名」があり、ファイル転送先のドメインを指定します。

Oracle Managed File TransferでHealthcareドメインを定義するには、「Healthcareとの統合」と「ドメインの管理」を参照してください。

ターゲット作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのターゲット-Healthcareに関する項を参照してください。

2.4.1.9 ODIターゲット・タイプ

ODIターゲット・タイプを使用することは、Oracle Data IntegratorアプリケーションのWebサービス・インタフェースにファイルを転送することを意味します。唯一の必須設定である「URL」は、ファイル転送先のWebサービス・エンドポイントを指定します。

Oracle Managed File TransferでODIドメインを定義するには、「Oracle Data Integratorとの統合」と「ドメインの管理」を参照してください。

ターゲット作成後に編集可能な他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのターゲット-ODIに関する項を参照してください。

2.4.2 配信後のファイルの移動と名前変更

ファイル、FTPリモートまたはsFTPリモートのターゲットを作成した後、そのターゲットを編集して、移動および名前変更をファイル操作として追加できます。

このプロセスの手順は次のとおりです。

1. 左側のペインのナビゲータで「ターゲット」の左にある矢印をクリックします。

ターゲットがリストされます。

2. ターゲット名をクリックするか、ターゲット名を右クリックして「開く」メニュー・アイテムを選択します。

そのターゲットのタブが開きます。

3. 「拡張プロパティ」の左にある矢印をクリックします。

「拡張プロパティ」セクションが開きます。

4. 「操作」サブタブをクリックします。

「操作」サブタブが開きます。

5. 「アクション・タイプ」ドロップダウン・リストから「移動」、「名前の変更」または「移動と名前変更」を選択します。

6. 「移動」または「移動と名前変更」を選択した場合、「物理ターゲット・ディレクトリ」フィールドにパスを入力します。

7. 「名前の変更」または「移動と名前変更」を選択した場合、「ファイル命名規則」フィールドにファイル名パターンを入力します。

ファイル名の一部に、タイムスタンプを表す%yyMMddHHmmssSSS%、連番を表す%SEQ%などの変数を使用できます。たとえば、File%SEQ%.txtは、File1.txt、File2.txtのように連続する番号が付けられたファイルを表します。詳細は、テクノロジ・アダプタの理解のアウトバウンド・ファイル命名規則の指定に関する項を参照してください。

8. ターゲットを保存して、オプションでデプロイします。

2.4.3 既存のターゲットの複製

既存のターゲットをコピーして、ファイル転送の新しいターゲットを作成できます。

このプロセスの手順は次のとおりです。

1. 次のどちらかの方法でターゲットを複製します。

- コピーするターゲットを選択し、左側のペインのナビゲータで「複製」アイコンを選択します。

- 左側のペインのナビゲータでコピーするターゲットを右クリックし、ポップアップ・メニューから「複製」コマンドを選択します。

「ターゲット」ダイアログが表示されます。

2. ターゲットの名前を入力します。

名前には、英字、数字、ダッシュおよびアンダースコアを使用できます。

3. 「作成」ボタンをクリックします。

ターゲットのタブが開き、編集可能な追加設定が表示されます。これらの設定の詳細は、「ターゲット・タイプ」と「配信後のファイルの移動と名前変更」のターゲット・タイプを参照してください。

ターゲットの作成を取り消すには、「取消」をクリックします。

4. 編集した後、「保存」ボタンをクリックします。

最後に保存した後のすべての変更を元に戻すには、「元に戻す」をクリックします。

5. 保存した後、「デプロイ」ボタンをクリックします。

このステップはオプションです。転送をデプロイする際、関連付けられているソースとターゲットが自動的にデプロイされます。

2.4.4 再試行間隔および再試行回数

ターゲットを作成した後、ターゲット・タイプを編集して再試行間隔と再試行回数を追加できます。

- 再試行間隔: ここでは、失敗した転送の配信を再試行するまでの秒数を指定します。

- 再試行回数: ここでは、失敗した転送を再試行する回数を指定します。

2.5 スケジュールの設定

特定の時刻または時間範囲にのみ実行されるように、ファイル配信をスケジュールできます。スケジュールが構成されていない場合、Oracle Managed File Transferによる処理と同時に、ファイルが配信されます。ソース・スケジュールはソース構成の一部として、ターゲット・スケジュールは転送構成の一部として、それぞれ構成できます。

リスニング対象のソースにスケジュールが定義されている場合、スケジュールされた時刻に達したときにのみファイルが検出されます。リスニング対象ではないソースの場合、ファイルはソースの場所に配置されると同時に検出されますが、ステータスは「スケジュール済」のままです。スケジュールされた時刻に達すると、ファイルが処理および配信されます。このソースを参照するすべての転送は、ソース・スケジュールの時刻に達したときにのみ実行されます。

ターゲットにスケジュールが定義されている場合、スケジュールされた時刻に達したときにのみファイルが配信されます。それまでは、ファイルは、ステータスが「スケジュール済」で、ソースの場所に配置されたままになります。1つの転送が参照する複数のターゲットがスケジュールを共有することはありません。

注意:

スケジュールを追加する前に、スケジュールなしの転送をテストして、正常に動作することを確認します。「転送のデプロイとテスト」を参照してください。

注意:

Oracle Managed File Transferは、OracleSystemUserとしてOracle Enterprise Scheduler Serviceと通信します。このユーザーを削除しないでください。削除した場合、「スケジュールの追加」をクリックすると、OracleSystemUserは存在しませんのメッセージが表示されて、監視レポートの「スケジュール詳細」は空欄になる可能性があります。ユーザーの詳細は、「ユーザーの構成」を参照してください。

このプロセスの手順は次のとおりです。

1. 左側のペインのナビゲータで「ソース」または「転送」の左にある矢印をクリックします。

ソースまたは転送がリストされます。

2. ソース名または転送名をクリックするか、ソース名または転送名を右クリックして「開く」メニュー・アイテムを選択します。

そのソースまたは転送のタブが開きます。

3. 「スケジュールの追加」オプションが表示されていない場合、表示させることができます。ソース・タブで、「ソース・スケジュール」の左にある矢印をクリックします。転送タブで、ターゲットの左にある矢印をクリックします。

4. 「スケジュールの追加」をクリックします。

「スケジューラ」ダイアログが開きます。

5. スケジュールの名前を入力します。

6. 「頻度」ドロップダウン・リストの「1回」、「毎時/分」、「毎日」、「毎週」、「毎月」、「毎年」または「カスタム」から値を選択します。

- 「1回」を選択した場合、「開始日」フィールドに日付と時間を入力します。

- 「毎時/分」を選択した場合、間隔を時間数と分数で指定します。「開始日」と、オプションで「終了日」を入力します。

- 「毎日」を選択した場合、間隔を日数で指定します。「開始日」と、オプションで「終了日」を入力します。

- 「毎週」を選択した場合、間隔を週数で指定します。「開始日」と、オプションで「終了日」を入力します。

- 「毎月」を選択した場合、「繰返し」オプションを選択します。

- 曜日指定: 「該当月の週」と「曜日」を選択します。「該当月の週」では、「最終」を選択できます。

- 日付別: 月の日または「月の最終日」を選択します。

「開始日」と、オプションで「終了日」を入力します。

- 「毎年」を選択した場合、「月」および「繰返し」オプションを選択します。

- 曜日指定: 「該当月の週」と「曜日」を選択します。「該当月の週」では、「最終」を選択できます。

- 日付別: 月の日または「月の最終日」を選択します。

「開始日」と、オプションで「終了日」を入力します。

「日付/時間」アイコンをクリックすると、入力しなくても日時を選択でき、別のタイムゾーンも選択できます。「時間のカスタマイズ」をクリックして、個々の配信時間を編集します。

7. 「頻度」ドロップダウン・リストで「カスタム」を選択した場合または「時間のカスタマイズ」をクリックした場合、「スケジューラ」ダイアログが展開され、表形式で時間が表示されます。

時間を追加するには、「時間の追加」をクリックし、「時間の追加」ダイアログで日付と時間を指定して「OK」をクリックします。これを、追加する時間ごとに繰り返します。

時間を削除するには、「時間の削除」をクリックします。削除した時間を復元するには、「元どおりに追加」をクリックします。

「時間のカスタマイズ」をクリックしていた場合、「頻度の変更」をクリックしてカスタム時間の追加を取り消すことができます。

8. ファイル配信可能な時間範囲を指定するには、「使用期間」を選択します。期間を時間数と分数で指定します。期間は「頻度」より小さくする必要があります。

期間は、転送が行われる時間の範囲です。たとえば、頻度が週次で、開始日が月曜日正午、期間が1時間の場合、ポーリングまたは転送は月曜の正午から午後1時までの間に1度のみ発生します。

9. 「OK」をクリックします。

スケジュールの追加を取り消すには、「取消」をクリックします。

10. ソースまたは転送を保存してデプロイします。

2.5.1 ポーリング頻度および最小経過時間を使用したスケジュール

最小経過時間は、次に示すリスニング・ソース・タイプに適用されます。

- リモートsFTP

- リモートFTP

- ファイル

- Storage Cloud Service

- Webcenter

スケジュールがこれらのソース・タイプに対して定義されている場合、ポーリング頻度および最小経過時間はスケジュール期間にのみ適用されます。ポーリング頻度の有効期限の前にスケジュールが終了すると、リスニング・ソース・タイプはポーリングされなくなります。

ポーリングのたび、またはスケジュールの有効期限時に、MFTは最小経過時間よりも大きい値の最終変更時間を持つファイルのみをダウンロードします。

2.6 転送のデプロイとテスト

転送および関連するソースとターゲットを作成した後、転送をデプロイして有効化し、設計通りに動作することを確認するためにテストします。

注意:

スケジュールを追加する前に、スケジュールなしの転送をテストして、正常に動作することを確認します。「スケジュールの設定」を参照してください。

2.6.1 ソース、ターゲットまたは転送のデプロイ

すべてのアーティファクト・タブに「デプロイ」ボタンがあります。転送でファイルを配信するには、先にデプロイする必要があります。ソースとターゲットは別々にデプロイして、複数の転送で使用できるようにできます。

デプロイメント・プロセスには、次の3つのステップがあります。

1. デプロイメント・ユーザー・インタフェースに、デプロイするファイルのリストが表示されます。

2. ファイルの検証が行われます。

3. 検証に成功した場合、アーティファクトがデプロイされます。

転送を初めてデプロイする際、関連付けられているソースとターゲットが保存されるだけでまだデプロイされていなかった場合は、それらも自動的にデプロイされます。ただし、最初のデプロイメントの後は、各アーティファクトは変更が行われるたびに個別に再デプロイする必要があります。

Oracle Managed File Transferは、アーティファクトのバージョンを管理します。アーティファクトをデプロイする場合、その現在のバージョンがデプロイされます。Oracle Managed File Transferランタイム・エンジンは、デプロイされているバージョンのみに基づいて動作します。

デプロイされているアーティファクトを監視、無効化およびアンデプロイできます。「デプロイされたソース、ターゲットおよび転送の監視」を参照してください。

2.6.2 転送結果の通知方法

デプロイされた転送をテストするには、転送が配信するように設計されているタイプのテスト・ファイルをソースの場所にコピーします。

コンテンツ・フィルタを適用した場合は、該当しないタイプのファイルが転送されないことを確認することもできます。「コンテンツ・フィルタの設定」を参照してください。

注意:

Oracle Managed File Transferの外部でFTPクライアントを使用してバイナリ・ファイルをソースの場所にコピーする際は、バイナリ転送として構成する必要があります。そうしないと、ファイルが破損する可能性があります。圧縮や暗号化などの処理アクションは正常に動作しない可能性があります。

2.6.2.1 受信したファイルの検出

テスト・ファイルがターゲットの場所に到着したことを確認することによって、転送が動作したことを確認できます。

圧縮や暗号化などの前処理アクションまたは後処理アクションを適用した場合、配信されたファイルを調べて、それらのアクションが実行されていることを確認できます。「ソース処理アクションの設定」と「転送の前処理と後処理のアクションの設定」を参照してください。

移動や名前変更などのアクションが発生したことを確認することもできます。「配信前のファイルのアーカイブと削除」と「配信後のファイルの移動と名前変更」を参照してください。

アクティブな配信のウォッチ

テスト・ファイルのサイズが大きい場合、「監視」ページの「ダッシュボード」タブでその進行状況を監視できます。「アクティブな配信の監視」を参照してください。

2.7 転送のインポートとエクスポート

転送をエクスポートすると、転送の構成および関連するソースとターゲットの構成がZIPファイルとして保存されます。ソースとターゲットは、個別にはエクスポートできません。

転送をエクスポートするには、転送タブで「エクスポート」をクリックし、その後はオペレーティング・システムのファイル保存手順に従います。

エクスポートされた転送をインポートできます。このプロセスの手順は次のとおりです。

1. 「管理」ページの「インポート/エクスポート」タブを開きます。

2. 「参照」をクリックします。

オペレーティング・システムのファイル・アップロード・ダイアログ・ボックスが開きます。

3. アップロードするファイルがあるディレクトリを選択します。

4. アップロードするZIPファイルを選択します。

5. 「開く」をクリックします。

「参照」ボタンの横の「インポート」テキスト・ボックスに、ファイルのフル・パスが表示されます。

6. 「インポート」をクリックします。

これにより、同じ名前の転送アーティファクトおよび同じ名前の関連するソースとターゲットが上書きされます。

3 カスタム・コールアウトによる転送の処理

この章では、Oracle Managed File Transfer (MFT)におけるファイル転送の前処理と後処理のためのカスタム・コールアウトの作成方法と使用方法を説明します。

コールアウトを作成するには、JavaおよびXMLコードに習熟しており、「アーティファクト(転送、ソースおよびターゲット)の設計」に説明されている転送の作成方法を習得している必要があります。

この章の内容は次のとおりです。

- カスタム・コールアウトの理解

- カスタム・コールアウトの作成: 概略手順

- コードの作成

- コールアウト定義ファイルの作成

- コールアウト・ディレクトリの位置特定

- createCalloutsコマンドの実行

- コールアウトのテスト

- 参照ファイル

- カスタム・コールアウトのチェックサムの検証

3.1 カスタム・コールアウトの理解

Oracle Managed File Transferには、転送の前処理および後処理用の組込みの圧縮、圧縮解除、暗号化および復号化の各アクションが用意されています。詳細は、「転送の前処理と後処理のアクションの設定」と「ソース処理アクションの設定」を参照してください。

カスタム・コールアウトと呼ばれる前処理アクションおよび後処理アクションを新しく作成できます。カスタム・コールアウト使用の例は、次のとおりです。

- コピーライト・ヘッダーおよびフッターの追加

- 内容の検証

- 配信が成功または失敗した場合の個別のアプリケーションへの通知

- 配信が成功または失敗した場合の個別のアプリケーションの起動

- MFTデータベースに永続化されているカスタム・ヘッダーまたはプロパティの追加

- 代替暗号化技術の追加

この章では、改行変換コールアウト例を使用します。

カスタム・コールアウトは、ソースまたはターゲットと関連付けることができます。転送時の処理アクションの実行順序は次のとおりです。

1. ソース前処理アクション

2. ターゲット前処理アクション

3. ペイロード配信

4. ターゲット後処理アクション

注意:

MFTコンソールでは、ターゲット処理アクションは転送時に構成されます。「アーティファクト(転送、ソースおよびターゲット)の設計」では、これらのアクションは転送処理アクションと呼ばれています。この章では、これらのアクションをターゲット処理アクションと呼びます。

注意:

後処理は、ファイル配信の後に実行されます。したがって、配信が成功して後処理が失敗した場合、「監視」ページの「ダッシュボード」タブの「アクティブな配信」ビューと「ファイル・ファインダ」ビューに表示されるステータスは異なります。具体的には、「アクティブな配信」ビューでは「完了」ステータスが表示されますが、「ファイル・ファインダ」ビューでは「失敗」ステータスが表示されます。

表3-1は、作成できるコールアウトのタイプをまとめたものです。

表3-1 コールアウトのタイプ

コールアウトのタイプ

インタフェース名

ペイロードの変更

ヘッダーおよびプロパティの変更

前処理

PreCalloutPlugin

使用可能

使用可能

後処理

PostCalloutPlugin

不可

使用可能

3.2 カスタム・コールアウトの作成: 概略手順

カスタム・コールアウトの作成の概略手順は次のとおりです。

1. 該当するインタフェースに基づいてJavaソース・コードを作成し、JARファイルにパッケージ化します。「コードの作成」を参照してください。

2. コールアウト・スキーマに基づいてコールアウト定義XMLファイルを作成します。「コールアウト定義ファイルの作成」を参照してください。

3. JARファイルとXMLファイルをコールアウト・ディレクトリにコピーします。「コールアウト・ディレクトリの位置特定」を参照してください。

4. createCallouts WLSTコマンドを実行して、MFTでコールアウトを構成します。「createCalloutsコマンドの実行」を参照してください。

5. コールアウトをファイル転送で使用して、コールアウトをテストします。「コールアウトのテスト」を参照してください。

次の各項では、改行変換コールアウト例を使用してこれらの手順を詳しく説明します。改行(行末中断や行端(EOL)マーカーとも呼ばれる)は、テキストの行の末尾を示す特殊文字または特殊文字列です。UNIXオペレーティング・システムでは、DOS (およびWindows)オペレーティング・システムとは異なる改行文字を使用します。このコールアウトを使用すると、改行文字をDOSからUNIXへ、またはUNIXからDOSへ変換できます。

3.3 コードの作成

この項の内容は次のとおりです。

- Javaコードに関する要件とヒント

- 改行変換例のJavaコード

3.3.1 Javaコードに関する要件とヒント

Javaコードでコールアウト・アクションを定義します。次の最低要件を満たす必要があります。

- java.io.IOException、java.io.InputStream、java.io.OutputStreamおよびjava.util.Mapの各クラスをインポートする必要があります。

- com.oracle.tip.mft.engine.processor.pluginパッケージ内のPluginOutputクラスとPluginContextクラスをインポートする必要があります。

- com.oracle.calloutパッケージ内のPreCalloutPluginインタフェースまたはPostCalloutPluginインタフェースを実装する必要があります。
インタフェースの内容については、「PreCalloutPluginインタフェース」または「PostCalloutPluginインタフェース」を参照してください。

- JARファイルにパッケージ化される必要があります。
複数のコールアウトを同じJARファイルに含めるか、個別のJARファイルにパッケージ化できます。

コールアウトでヘッダー変数を設定するには、次のようなコードを使用します。

context.getCustomPropertyMap().put("name", "value");
context.getTransportHeaderMap().put("name", "value");

コールアウトでペイロード・ファイル名前を変更するには、次のようなコードを使用します。

PluginOutput pOutput = new PluginOutput();
pOutput.setNewFileName("abc.xyz");
return pOutput;

コールアウトでソース前処理、ソース後処理、ターゲット前処理およびターゲット後処理の各種アクションを実行するには、次のようなコードを使用します。

if(message instanceof oracle.tip.mft.bean.SourceMessage){
// in case of source pre and post processing
} else if(message instanceof oracle.tip.mft.bean.Instance){
// in case of target pre
} else if(message instanceof oracle.tip.mft.bean.TargetMessage ){
// in case of target post
}

コードをコンパイルするには、クラスパスにコアMFT JARファイルを指定して次のようなコマンドを使用します。

javac -classpath $MW_HOME/mft/modules/oracle.mft/core.jar <class>

JARファイルを作成するには、次のコマンドを使用します。

jar cf newlineConversion.jar

3.3.2 改行変換例のJavaコード

改行変換例のJavaクラスは、次のアクションを実行します。

1. コールアウトがペイロードを変更するように指定します。

2. Typeパラメータ値を受け入れ、コールアウトがDos2UnixとUnix2Dosのいずれであるかを指定します。

3. Type値を指定しないとnullが返されます。

4. doLineConversionメソッドを使用してペイロードの各行を、選択した改行文字で書き直します。

5. 改行が変更されたペイロード・ファイルのコピーが返されます。

「例 - 改行変換コード」は、改行変換例のJavaクラス・コードを示しています。

package com.oracle.callout.sample;

import java.io.BufferedReader;
import java.io.BufferedWriter;
import java.io.DataInputStream;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.util.Map;

import oracle.tip.mft.engine.processsor.plugin.PluginContext;
import oracle.tip.mft.engine.processsor.plugin.PluginOutput;
import oracle.tip.mft.engine.processsor.plugin.PreCalloutPlugin;

public class NewlineConversion implements PreCalloutPlugin {

@Override
public boolean isPayloadChangeRequired(PluginContext context,
Map<String, String> calloutParams) {
return true;
}

@Override
public PluginOutput process(PluginContext context, InputStream input,
OutputStream out, Map<String, String> calloutParams) {
String type = calloutParams.get("Type");
boolean isDos = false;
if ("Unix2Dos".equals(type)) {
isDos = true;
}
doLineConversion(input, out, isDos);
return new PluginOutput();
}

@Override
public PluginOutput process(PluginContext context, InputStream input,
Map<String, String> calloutParams) {
return null;
}

public static final String DOS_NEW_LINE = "\r\n";
public static final String UNIX_NEW_LINE = "\n";

private void doLineConversion(InputStream in, OutputStream out,
boolean isDos) {
String newLineChar = null;
if (isDos) {
newLineChar = DOS_NEW_LINE;
} else {
newLineChar = UNIX_NEW_LINE;
}
BufferedReader bufferIn = null;
BufferedWriter bufferOut = null;
try {
DataInputStream dataIn = new DataInputStream(in);
bufferIn = new BufferedReader(new InputStreamReader(dataIn));
DataOutputStream dataOut = new DataOutputStream(out);
bufferOut = new BufferedWriter(new OutputStreamWriter(dataOut));
// For each line in the un-normalized file
String line;
while ((line = bufferIn.readLine()) != null) {
// Write the original line plus the operating-system dependent
// newline
bufferOut.write(line);
bufferOut.write(newLineChar);
}
} catch (Exception e) {
throw new RuntimeException(e);
} finally {
try {
bufferIn.close();
bufferOut.close();
} catch (IOException e) {
throw new RuntimeException(e);
}
}
}
}

3.4コールアウト定義ファイルの作成

定義ファイルでMFT構成のコールアウト構造を指定します。定義ファイルは次の最低要件を満たす必要があります。

- callout.xsdスキーマ・ファイルで指定したXML形式に準拠している必要があります。スキーマ・ファイルの内容については、「コールアウト定義スキーマ」を参照してください。
複数のコールアウトを同じ定義ファイルに含めるか、個別の定義ファイルにパッケージ化できます。

- デバッグが不十分な、無限ループを含むコールアウトが非常に長い時間実行されるのを防止するため、Callout要素のtimeout属性に値(秒単位)が指定されている必要があります。

- Callout要素のimplementationClass属性は、パッケージ名などのJavaクラス名を参照する必要があります。

- Callout要素のlibraryName属性は、JARファイル名を参照する必要があります。

- Javaクラスに入力パラメータがある場合は、対応するParameter要素を指定する必要があります。

「例 - 改行変換コールアウト定義ファイル」は、改行変換例のコールアウト定義ファイルを示しています。

例 - 改行変換コールアウト定義ファイル

<?xml version="1.0" encoding="UTF-8"?>
<mft:Callouts xmlns:mft="http://xmlns.oracle.com/mft"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.oracle.com/mft callout.xsd ">
<mft:Callout description="New line conversion"
helpText="New line conversion"
groupName="Source-pre,Target-pre" timeout="300"
implementationClass="com.oracle.callout.sample.NewlineConversion"
libraryName="newlineConversion.jar" name="New line conversion">
<mft:Parameter description="Type" mandatory="true" helpText="Type"
name="Type" listValue="Dos2Unix,Unix2Dos"
parameterType="string" defaultValue="Dos2Unix"/>
</mft:Callout>
</mft:Callouts>

3.5 コールアウト・ディレクトリの位置特定

JARファイルと定義ファイルを作成したら、それらのファイルをMFTコールアウト・ディレクトリにコピーする必要があります。このディレクトリのデフォルトの場所は次のとおりです。

FMW_HOME/user_projects/domains/soainfra/mft/callouts

この場所を確認するには、MFT構成を調べます。

このプロセスの手順は次のとおりです。

1. 「管理」ページに移動します。

2. 左側のナビゲーション・ペインで、「サーバー・プロパティ」をクリックします。

3. ページの上端付近にある「コールアウト・ディレクトリ」設定を調べます。

3.6 createCalloutsコマンドの実行

JARファイルと定義ファイルをMFTコールアウト・ディレクトリにコピーしたら、createCalloutsコマンドを使用してコールアウト定義をMFT構成にアップロードする必要があります。

このプロセスの手順は次のとおりです。

1. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを起動します。

2. createCalloutsコマンドを使用してコールアウト定義ファイルのフルパスを指定します。

crtCalls('/home/user_projects/domains/soainfra/mft/callouts/Newline.xml')

例では、crtCallsという省略形を使用します。

3. listCalloutsコマンドを使用してコールアウトが追加されたことを確認します。

listCallouts()

4. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを終了します。

MFT WLSTコマンドの詳細は、SOA Suite WLSTコマンド・リファレンスのMFTのWLSTコマンドの要約およびMFTカスタムWLSTコマンドを参照してください。

3.7 コールアウトのテスト

コールアウトを作成してコールアウト定義をアップロードしたら、コールアウトをテストして設計どおりに機能することを確認する必要があります。

カスタム・コールアウトのテストの概略手順は次のとおりです。

1. コールアウトをソースとターゲットに追加して、関連付けられた転送をデプロイします。「ソースへのコールアウトの追加」または「ターゲットへのコールアウトの追加」を参照してください。

2. 転送を実行したら、ソースまたはターゲットのレポートを調べます。「コールアウト・アクションを確認するためのレポートの表示」を参照してください。

3. エラー修正や改善が必要な場合はコールアウトを更新します。「コールアウトの更新」を参照してください。

注意:

createCalloutsコマンドを実行するときにMFTコンソールにログインした場合は、コールアウトをソースまたはターゲットに追加するには、事前にMFTコンソールからログアウトして再度ログインする必要があります。

3.7.1 ソースへのコールアウトの追加

改行変換コールアウトをソースに追加する手順は次のとおりです。

1. 左側のペインのナビゲータで「ソース」の左にある矢印をクリックします。

ソースがリストされます。

2. ソース名をクリックするか、ソース名を右クリックして「開く」メニュー・アイテムを選択します。

そのソースのタブが開きます。

3. 「アクション」の左にある矢印をクリックします。

「アクション」セクションが開きます。

4. 「処理アクションの追加」をクリックします。

「処理アクション」ダイアログが開きます。

5. 「すべてのアクション」ドロップダウン・リストで、改行変換を選択します。

6. 「リストに追加」をクリックします。

リストからアクションを削除するには、アクションの右にある「削除」アイコンをクリックします。

7. 「タイプ」テキスト・ボックスにDos2UnixまたはUnix2Dosと入力します。

8. 「OK」をクリックします。

アクションの追加を取り消すには、「取消」をクリックします。

9. ソースを保存して、オプションでデプロイします。

10. ソースを転送に追加し、「デプロイ」を選択して転送をデプロイします。

詳細は、「転送のデプロイとテスト」を参照してください。

3.7.2 ターゲットへのコールアウトの追加

改行変換コールアウトをターゲットに追加する手順は次のとおりです。

1. 左側のペインのナビゲータで「転送」の左にある矢印をクリックします。

転送がリストされます。

2. 転送名をクリックするか、転送名を右クリックして「開く」メニュー・アイテムを選択します。

その転送のタブが開きます。

3. ターゲットの左にある矢印をクリックします。

ターゲット設定が表示されます。

4. 「前処理アクションの追加」をクリックします。

「前処理アクション」ダイアログが開きます。

5. 「すべてのアクション」ドロップダウン・リストで、改行変換を選択します。

6. 「リストに追加」をクリックします。

リストからアクションを削除するには、アクションの右にある「削除」アイコンをクリックします。

7. 「タイプ」テキスト・ボックスにDos2UnixまたはUnix2Dosと入力します。

8. 「OK」をクリックします。

アクションの追加を取り消すには、「取消」をクリックします。

9. 転送を保存してデプロイします。

詳細は、「転送のデプロイとテスト」を参照してください。

3.7.3 コールアウト・アクションを確認するためのレポートの表示

ソースまたはターゲットのレポートにアクセスするには、「監視」ページに移動し、「ソース、転送およびターゲットのレポートの解釈」を参照してください。

改行変換コールアウトは、ソース・レポートの「ソース前処理」表または、ターゲット・レポートの「ターゲット前処理」表に表示されています。コールアウト・アクションが成功した場合は、どちらの表の「ステータス」列にも「処理済」と表示されます。

さらに、コールアウト・アクションが成功した場合は、レポートの「拡張」セクションの「メッセージ・プロパティ」フィールドにpayloadModified=yesと表示されます。

詳細は、「ソース・レポート」または「ターゲット・レポート」を参照してください。

3.7.4 コールアウトの更新

コールアウトを更新するときは次の点に留意してください。

- コールアウトを作成または更新するときは、MFTサーバーの再起動は必要ありません。

- Javaコードのみを変更してパラメータを変更しない場合は、必要な作業は新しいJARファイルをコールアウト・ディレクトリにコピーすることのみです。

- 定義ファイルを変更してパラメータを変更しない場合は、必要な作業はupdateCalloutsコマンドを使用して新しいコールアウト定義に再ロードすることのみです。

- コールアウト・パラメータの追加、削除または変更を行った場合は、次の手順を実行する必要があります。

1. deleteCalloutコマンドを使用してコールアウトを削除します。

2. createCalloutsコマンドを使用してコールアウトを再作成します。

3. 新しいコールアウト・バージョンを使用するようにソースまたはターゲットを再構成します。

MFT WLSTコマンドの詳細は、『SOA Suite WLSTコマンド・リファレンス』の「MFTのWLSTコマンドの要約」およびMFTコールアウト・コマンドに関する項を参照してください。

3.8 参照ファイル

この項では、次のファイルの内容を示します。

- PreCalloutPluginインタフェース

- PostCalloutPluginインタフェース

- コールアウト定義スキーマ

3.8.1 PreCalloutPluginインタフェース

「例 - PreCalloutPluginインタフェース」は、com.oracle.callout.PreCalloutPluginインタフェースのJavaコードを示しています。

例 - PreCalloutPluginインタフェース

public interface PreCalloutPlugin {

/**
* Depending on the return of this function output stream for changing the
* pay load content will be passed. Only if the payload change is required
* return true.
*
* @param context
* @param calloutParams
* @return
*/
public boolean isPayloadChangeRequired(final PluginContext context,
final Map<String, String> calloutParams);

/**
* This function will be called only if the isPayloadChangesRequired returns
* true. This method must write final pay load content to the output stream.
* Any custom properties or the header properties can be set at the context
* level.
*
* @param context
* @param input
* @param out
* @param calloutParams
* @return
*/
public PluginOutput process(final PluginContext context,
final InputStream input, OutputStream out,
final Map<String, String> calloutParams);

/**
* This function will be called only if the isPayloadChangesRequired returns
* false. Any custom properties or the header properties can be set at the
* context level.
*
* @param context
* @param input
* @param out
* @param calloutParams
* @return
*/
public PluginOutput process(final PluginContext context,
final InputStream input, final Map<String, String> calloutParams);
}

3.8.2 PostCalloutPluginインタフェース

「例 - PostCalloutPluginインタフェース」は、com.oracle.callout.PostCalloutPluginインタフェースのJavaコードを示しています。

例 - PostCalloutPluginインタフェース

public interface PostCalloutPlugin {

/**
* Any custom properties or the header properties can be set at the
* context level.
*
* @param context
* @param input
* @param out
* @param calloutParams
* @return
*/
public PluginOutput process(final PluginContext context,
final InputStream input, final Map<String, String> calloutParams);
}

3.8.3 コールアウト定義スキーマ

callout.xsdファイルでは、コールアウト定義XMLファイルの形式を定義します。「例 - コールアウト定義スキーマ」はコンテンツを表示します。

例 - コールアウト定義スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema targetNamespace="http://xmlns.oracle.com/mft"
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:mft="http://xmlns.oracle.com/mft"
elementFormDefault="qualified">

<xsd:element name="Callouts">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Callout" minOccurs="0" maxOccurs="unbounded">
<xsd:complexType>
<xsd:sequence>
<xsd:element minOccurs="0" maxOccurs="unbounded" ref="mft:Parameter"/>
</xsd:sequence>
<xsd:attribute name="name" use="required">
<xsd:simpleType>
<xsd:restriction base="mft:non-empty-string">
<xsd:maxLength value="128"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
<!-- multiple values separated by comma are supported, possible values
Source-pre, Target-pre, Target-post -->
<xsd:attribute name="groupName" type="mft:non-empty-string" use="optional"/>
<xsd:attribute name="implementationClass" type="mft:non-empty-string"/>
<!-- jar name -->
<xsd:attribute name="libraryName" type="mft:non-empty-string"/>
<xsd:attribute name="timeout" type="xsd:integer" use="optional"
default="30"/>
<xsd:attribute name="description" type="mft:non-empty-string"/>
<xsd:attribute name="helpText" type="mft:non-empty-string"/>
</xsd:complexType>
<xsd:unique name="Callout_UK">
<xsd:selector xpath="mft:Callout"/>
<xsd:field xpath="@name"/>
</xsd:unique>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>

<xsd:element name="Parameter">
<xsd:complexType>
<xsd:attribute name="name" type="mft:non-empty-string" use="required"/>
<xsd:attribute name="parameterType" type="mft:parameterTypeLOV"
use="required"/>
<xsd:attribute name="basic" type="boolean" use="optional" default="false"/>
<xsd:attribute name="mandatory" type="boolean" use="optional"
default="false"/>
<xsd:attribute name="hidden" type="boolean" use="optional" default="false"/>
<!-- multiple values separated by comma is supported -->
<xsd:attribute name="groupName" type="mft:non-empty-string"
use="optional"/>
<!-- sub-groups can have multiple values separated by comma. -->
<xsd:attribute name="sub-groups" type="mft:non-empty-string"
use="optional"/>
<!-- VRule: defaultValue and parameterTypeLOV MUST match -->
<xsd:attribute name="defaultValue" type="mft:non-empty-string"
use="optional"/>
<xsd:attribute name="listValue" type="mft:non-empty-string"
use="optional"/>
<xsd:attribute name="mapValue" type="mft:non-empty-string"
use="optional"/>
<!-- changed refValue from IDREF to non-empty-string as IDREF does not allow ",". In the
future refValue can have value separated by ",". Ex: "xPathaParams, someOtherParams" -->
<xsd:attribute name="refValue" type="mft:non-empty-string" use="optional"/>
<!--attribute name="tpOverrideable" type="boolean" use="optional" default="true"/-->
<xsd:attribute name="overrideLevel" type="mft:overrideLevelLOV"
use="optional" default="all"/>
<xsd:attribute name="displayName" type="mft:non-empty-string"/>
<xsd:attribute name="description" type="mft:non-empty-string"/>
<xsd:attribute name="helpText" type="mft:non-empty-string"/>
</xsd:complexType>
</xsd:element>

<xsd:simpleType name="overrideLevelLOV">
<xsd:restriction base="string">
<xsd:enumeration value="admin"/>
<xsd:enumeration value="tp"/>
<xsd:enumeration value="host"/>
<xsd:enumeration value="tpa"/>
<xsd:enumeration value="all"/>
</xsd:restriction>
</xsd:simpleType>

<xsd:simpleType name="non-empty-string">
<xsd:restriction base="string">
<xsd:minLength value="1"/>
</xsd:restriction>
</xsd:simpleType>

<xsd:simpleType name="parameterTypeLOV">
<xsd:restriction base="string">
<xsd:enumeration value="float"/>
<xsd:enumeration value="integer"/>
<xsd:enumeration value="string"/>
<xsd:enumeration value="boolean"/>
<xsd:enumeration value="date"/>
<xsd:enumeration value="SO"/>
<xsd:enumeration value="MO"/>
<xsd:enumeration value="credential"/>
<xsd:enumeration value="list"/>
<xsd:enumeration value="map"/>
<xsd:enumeration value="ref"/>
<xsd:enumeration value="hex"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>

3.9 カスタム・コールアウトを使用した検証

カスタム・コールアウト・アクションを検証できます。たとえば、チェックサムを検証する際に、コールアウト実装のプラグイン出力に例外オブジェクトを設定して検証できます。

検証用のコードは次のとおりです。

public PluginOutput process(PluginContext context, InputStream input,
Map<String, String> calloutParams) {
PluginOutput res = new PluginOutput() ;
boolean isValid = validateChecksum(context, input, calloutParams) ;
if( ! isValid ){res.setException(new Exception("Checksum mismatch, corrupted payload.")) ;

}
return res ;
}

前述の例のチェックサム・アクション・ステータスはインスタンス・レポート・ページで失敗します。メッセージ・ステータスは「失敗[前処理]」になります。

4 Oracle Managed File Transferと他の製品の統合

この章では、アプリケーション統合におけるOracle Managed File Transfer (MFT)の使用方法を説明します。

この章の内容は次のとおりです。

- 互換性のあるテクノロジと統合戦略

- ドメインの管理

- Oracle SOA Suiteとの統合

- Oracle Service Busとの統合

- B2Bとの統合

- Healthcareとの統合

- Oracle Data Integratorとの統合

- Webサービスとの統合

- MFT WSDLファイル

4.1 互換性のあるテクノロジと統合戦略

「互換テクノロジと統合戦略」に、Oracle Managed File Transferと互換性のあるテクノロジと基本的な統合戦略の概要を示します。

表4-1 Oracle Managed File Transferの互換テクノロジと統合戦略

テクノロジ

ソースおよびターゲットのタイプ

統合戦略

ファイル・システム

ファイル、FTPリモート、sFTPリモート、FTP埋込み、sFTP埋込み

標準ファイル管理とFTPコマンドまたはsFTPコマンドを使用します。

Webサービス

SOAP、SOA、Service Bus、ODI

ソースまたはターゲットをWebサービスとして認識するように統合アプリケーションを構成します。

B2B

B2B、Healthcare

ソースまたはターゲットを取引パートナのチャネルまたはエンドポイントとして認識するように統合アプリケーションを構成します。

各テクノロジの統合アプリケーションはそれぞれに異なる方法でOracle Managed File Transferを認識します。いくつか例を挙げます。

- Oracle Managed File TransferのSOAソースは、SOAのMFT参照バインディング・コンポーネントに対応します。

- Oracle Managed File TransferのSOAターゲットは、SOAのMFTサービス・バインディング・コンポーネントに対応します。

- Oracle Managed File TransferのService Busソースは、Oracle Service Busのビジネス・サービスに対応します。

- Oracle Managed File TransferのService Busターゲットは、Oracle Service Busのプロキシ・サービスに対応します。

SOAなどの一部の統合アプリケーションは、特定のコンポーネントまたは設定によってOracle Managed File Transferを認識します。Oracle Service Busなどのその他の統合アプリケーションは、テクノロジに従ってOracle Managed File Transferを認識します。

4.2 ドメインの管理

SOA、Service Bus、B2B、HealthcareおよびODIが同じOracle WebLogic Serverインスタンスに配置されていない場合やOracle Managed File Transferによってクラスタ化されていない場合は、これらの統合アプリケーションのソースおよびターゲットのドメインを構成する必要があります。

このプロセスの手順は次のとおりです。

1. 「管理」ページの「ドメイン」タブを開きます。

2. 「追加」アイコンをクリックします。
ドメイン表に空の行が追加されます。

3. 表のセルに次の情報を入力します。

- ドメインの別名: ドメインに接続するためのホスト名。
ソースまたはターゲットの「ドメインの別名」設定は、この別名にマッピングされます。

- 接続URL: リモート・サーバー上で実行されているB2BおよびHealthcareアプリケーションに接続するためのサービス・エンドポイントURL。これらのサーバーは、Oracle Managed File Transferと同じOracle WebLogic Serverドメイン内または別のドメインで実行できます。B2BおよびHealthcareターゲットへのメッセージの送信に使用されます。

- ユーザー: ドメインにアクセスするために使用するユーザー。

- パスワード: ユーザー・パスワード。

- パスワードの確認: ユーザー・パスワードの確認。

- トラッキングURL: ファイルの転送のソースまたはターゲットのURL (そのURLが「接続URL」と異なる場合)。詳細は、「トラッキングURLの指定」を参照してください。

- タイプ: ドメイン・タイプ(「B2B」、「Healthcare」、「SOA」、「Service Bus」または「ODI」)。
これは単なるオプションのラベルです。ソースおよびターゲット・タイプに使用可能なドメインは決定しません。

- 摘要: ドメインのテキスト説明。

- 例: t3://host:port (B2Bを実行中のWLSサーバーのホストおよびポートの詳細)。

4. 「ドメイン詳細の表示」をクリックして、選択したドメインの参照ソースおよびターゲットのリストの表示します。
デフォルトでは、すべてのソースとターゲットのタイプがリストされます。「B2B」、「Healthcare」、「SOA」、「Service Bus」または「ODI」のチェックを解除すると、そのタイプのソースおよびターゲットを非表示にすることができます。

5. 「保存」をクリックします。

ドメインを削除するには、表の行を選択し、「削除」アイコンをクリックします。前回保存以降の変更をすべて取り消すには、「元に戻す」をクリックします。

ドメインの別名を参照するソースおよびターゲットを作成した後、ドメインを選択して「ドメイン詳細の表示」をクリックすると、それらの参照ソースおよびターゲットを表示できます。

4.2.1 トラッキングURLの指定

「トラッキングURL」は、ファイルの転送のソースまたはターゲットの場所のURL (そのURLが「接続URL」と異なる場合)です。

すべてのドメイン・タイプにおいて、トラッキングURLは統合される製品の各レポート・モジュールへのアクセスに使用されるコンソールURLです。このURLには、ロード・バランサのIPまたはサーバー・アドレスを指定できます。Oracle Managed File Transfer監視モジュールから各レポート・ページを開くための動的URLの生成で使用されます。サンプルは、「連結されたSOAレポートとMFTレポート」、「連結されたB2BレポートとMFTレポート」、「連結されたHealthcareレポートとMFTレポート」などを参照してください。

ソースまたはターゲットの「ドメインの別名」を選択すると、すべての構成済ドメインをB2BおよびHealthcareターゲットで使用可能ですが、B2BおよびHealthcareのソースと、SOA、Service BusおよびODIのソースとターゲットに対してはトラッキングURLが指定されたドメインのみを使用できます。

B2Bリモート統合の接続URLはB2B管理対象サーバーを指します 。ただし、リモートB2Bレポート統合は、かわりにロード・バランサのHTTP URLを使用することがあります。その場合は、トラッキングURLを指定する必要があります。

Oracle SOA Suite用の接続URLは、SOA管理対象サーバーを指します。ただし、Oracle Enterprise Manager Fusion Middleware Controlは管理サーバーで実行されるため、フロー・トレース・ナビゲーションのURLは異なります。したがって、「連結されたSOAレポートとMFTレポート」の説明どおりにレポートの連結が確実に機能するようにするために、トラッキングURLを指定する必要があります。

トラッキングURLの構文は次のとおりです。

http://host:port#domain_name#domain_type

オプションのdomain_typeのデフォルトは、weblogic_domainです。

たとえば、MFTコンソールURLがmft.example.com:8001で、MFTとSOA用のFusion Middleware Controlの両方が同じmft_domainにある場合は、次のURLをトラッキングURLとして使用します。

http://mft.example.com:8001#mft_domain

Fusion Middleware ControlコンソールURLがsoa.example.com:21374で、Fusion Middleware ControlがWLS_SOAドメインにある場合は、次のURLをトラッキングURLとして使用します。

http://soa.example.com:21374#WLS_SOA

4.3 Oracle SOA Suiteとの統合

Oracle JDeveloperの「BPELサービス」にはBPELプロセスでOracle Managed File Transferソースまたはターゲットを表す専用のMFTコンポーネントがあります。Oracle Managed File TransferでタイプがSOAのソースまたはターゲットを作成した後、SOAアプリケーションで対応するMFTコンポーネントを作成します。

SOAとMFTの間の統合では、複数のWSDLファイルが使用されます。詳細は、「MFT WSDLファイル」を参照してください。

Oracle SOA SuiteがMFTと同じ場所に配置されていない場合は、Oracle Managed File TransferでSOAドメインを構成する必要があります。「連結されたSOAレポートとMFTレポート」の説明どおりにレポートの連結が確実に機能するようにするために、トラッキングURLを指定する必要があります。詳細は、「トラッキングURLの指定」を参照してください。

4.3.1 SOAソースのMFT参照の作成

Oracle Managed File TransferのSOAソースは、SOAのMFT参照バインディング・コンポーネントに対応します。SOAアプリケーションはファイルを送信します。

このプロセスの手順は次のとおりです。

1. Oracle JDeveloperで新しいSOAアプリケーションとSOAプロジェクトを作成します。

2. プロジェクトを開いて、「コンポーネント・パレット」の「テクノロジ」セクションを表示します。

3. MFTコンポーネント・アイコンを右の「パートナ」スイムレーンにドラッグ・アンド・ドロップします。MFT構成ウィザードが開きます。

4. MFTアダプタ参照ページで、mftReferencenumberの名前を指定するか、デフォルト名を受け入れます。バインディングとして「参照」が選択されます。「次へ」をクリックします。

5. 「アダプタ・インタフェース」ページで、「新規MFT参照を使用して定義」を選択します。「次へ」をクリックします。

6. 「サービス接続」ページで、「AppServer接続」ドロップダウン・リストからOracle Managed File TransferがインストールされているOracle WebLogic Serverへの接続を選択します。Oracle Managed File Transferが実行される管理対象サーバーが自動入力されない場合は、「SOAサーバー」ドロップダウン・リストからその管理対象サーバーを選択します。「MFTのテスト」をクリックして、Oracle Managed File Transferとの通信をテストします。「次へ」をクリックします。

7. 「参照構成」ページで、「ソース」ドロップダウン・リストからMFTソース名を選択します。エンドポイントの場所は、「エンドポイント」フィールドに自動入力されます。「終了」をクリックします。

8. BPELプロセスにMFTコンポーネントが表示されます。他の外部参照と同じようにこれを使用します。

4.3.2 SOAターゲットのMFTサービスの作成

Oracle Managed File TransferのSOAターゲットは、SOAのMFTサービス・バインディング・コンポーネントに対応します。SOAアプリケーションはファイルを受信します。

このプロセスの手順は次のとおりです。

1. Oracle JDeveloperで新しいSOAアプリケーションとSOAプロジェクトを作成します。

2. プロジェクトを開いて、「コンポーネント・パレット」の「テクノロジ」セクションを表示します。

3. MFTコンポーネント・アイコンを左の「パートナ」スイムレーンにドラッグ・アンド・ドロップします。MFT構成ウィザードが開きます。

4. MFTアダプタ参照ページで、mftServicenumberの名前を指定するか、デフォルト名を受け入れます。バインディングとして「サービス」が選択されます。「終了」をクリックします。

5. BPELプロセスにMFTコンポーネントが表示されます。他の公開されたサービスと同じようにこれを使用します。

4.3.3 連結されたSOAレポートとMFTレポート

SOAソースまたはターゲットのOracle Managed File Transferインスタンス・レポートには、「相関フローID」リンクが含まれています。このリンクをクリックすると、SOAインスタンスのOracle Enterprise Manager Fusion Middleware Controlの対応する「フローのトレース」ページが開きます。

同様に、Oracle Managed File TransferのFusion Middleware Controlフロー・トレースの「転送」セクションには「Managed File Transfer」リンクが含まれています。このリンクをクリックすると、対応するOracle Managed File Transferインスタンスのレポートが開きます。

Oracle SOA SuiteがMFTと同じ場所に配置されていない場合にレポートの連結が確実に機能するようにするために、トラッキングURLを指定する必要があります。詳細は、「トラッキングURLの指定」を参照してください。

Oracle Managed File Transferインスタンスのレポートの詳細は、「ソース、転送およびターゲットのレポートの解釈」を参照してください。

4.4 Oracle Service Busとの統合

Oracle Service Busは、発信データにビジネス・サービスを使用し、着信データにプロキシ・サービスを使用します。Oracle Managed File Transferの対応するエンドポイントは、それぞれ、Service BusソースとService Busターゲットです。

Oracle Service BusがMFTと同じ場所に配置されていない場合は、Oracle Managed File TransferでService Busドメインを構成する必要があります。詳細は、「ドメインの管理」を参照してください。

4.4.1 Service Busソースのビジネス・サービスの作成

Oracle Managed File TransferのService Busソースは、Oracle Service Busのビジネス・サービスに対応します。Oracle Service BusがOracle Managed File Transferをコールし、Oracle Service Busがファイルを送信します。ビジネス・サービスは、Oracle JDeveloperまたはOracle Service Busコンソールから作成できます。

詳細は、Oracle Service Busでのサービスの開発のビジネス・サービスの作成と構成に関する項を参照してください。

4.4.1.1 Oracle JDeveloperでのビジネス・サービスの作成

このプロセスの手順は次のとおりです。

1. ビジネス・サービスを追加するアプリケーションおよびプロジェクトを開くか作成します。

2. アプリケーション・ナビゲータで、プロジェクトを右クリックし、「新規」→「ビジネス・サービス」を選択して、ビジネス・サービスの作成ウィザードを表示します。説明されていないウィザード・ページについては、デフォルト値を受け入れて「次」をクリックします。

3. 「ビジネス・サービス」の「サービスの作成」ページで、名前を入力し、「定義」を「WSDL」に設定します。

4. 「参照」をクリックします。WLS_Home/mft/integration/wsdlディレクトリに移動し、MFTSOAService.wsdlファイルを選択します。「OK」をクリックします。

このファイルの詳細は、「MFT WSDLファイル」を参照してください。

5. 「サービスの作成」ページに「WSDL設定」が表示されます。「次へ」をクリックします。

6. 「ビジネス・サービス」の「トランスポート構成」ページで、「プロトコル」をhttpに設定します。Service Busソースの「URL」設定と一致するように「エンドポイントURI」を設定します。「作成」をクリックします。

7. 新しいビジネス・サービスの一般構成が表示されたビジネス・サービス定義エディタが開きます。

4.4.1.2 Oracle Service Busコンソールでのビジネス・サービスの作成

このプロセスの手順は次のとおりです。

1. Oracle Managed File TransferのWSDLファイルをOracle Service Busプロジェクトにインポートします。このファイルのフルパスは、WLS_Home/mft/integration/wsdl/ MFTSOAService.wsdlです。

このファイルの詳細は、「MFT WSDLファイル」を参照してください。

Service Bus側の手順は、Oracle Service Busでのサービスの開発のリソースと構成のインポートおよびエクスポートに関する項を参照してください。

2. 「リソース」パネルで、ビジネス・サービスを追加するプロジェクトを選択し、「作成」アイコンの横にある下矢印をクリックします。

3. 「ビジネス・サービス」を選択して、ビジネス・サービスの作成ウィザードを表示します。

4. 「作成」ページの「サービスの作成」セクションで、ビジネス・サービスの名前を入力します。

5. 「作成」ページの「サービス定義」セクションで、「WSDLベース・サービス」を選択します。

6. 「検索」アイコンをクリックしてWSDLリソースを検索します。すべてのフィールドを空白にして、「検索」をクリックします。これにより、すべてのインポート済WSDLファイルが検索されます。検索結果表でOracle Managed File TransferのWSDLファイルを選択します。「OK」をクリックします。

7. WSDLファイルを指定したら、「ポート/バインド」フィールドから、使用するポートまたはバインディングを選択します。「次へ」をクリックします。

8. 「トランスポート」ページで、「プロトコル」をhttpに設定します。Service Busターゲットの「URL」設定と一致するように「エンドポイントURI」を設定します。「作成」をクリックします。

9. 新しいビジネス・サービスの一般構成が表示されたビジネス・サービス定義エディタが開きます。

4.4.2 Service Busターゲットのプロキシ・サービスの作成

Oracle Managed File TransferのService Busターゲットは、Oracle Service Busのプロキシ・サービスに対応します。Oracle Managed File TransferがOracle Service Busをコールし、Oracle Service Busがファイルを受信します。プロキシ・サービスは、Oracle JDeveloperまたはOracle Service Busコンソールから作成できます。

詳細は、Oracle Service Busでのサービスの開発のプロキシ・サービスの作成と構成に関する項を参照してください。

4.4.2.1 Oracle JDeveloperでのプロキシ・サービスの作成

このプロセスの手順は次のとおりです。

1. プロキシ・サービスを追加するアプリケーションおよびプロジェクトを開くか作成します。

2. アプリケーション・ナビゲータで、プロジェクトを右クリックし、「新規」→「プロキシ・サービス」を選択して、プロキシ・サービスの作成ウィザードを表示します。説明されていないウィザード・ページについては、デフォルト値を受け入れて「次」をクリックします。

3. 「プロキシ・サービス」の「サービスの作成」ページで、名前を入力し、「定義」を「WSDL」に設定します。

4. 「参照」をクリックします。WLS_Home/mft/integration/wsdlディレクトリに移動し、MFTAnyTypeService.wsdlファイルを選択します。「OK」をクリックします。
このファイルの詳細は、「MFT WSDLファイル」を参照してください。

5. 「サービスの作成」ページに「WSDL設定」が表示されます。「次へ」をクリックします。

6. 「プロキシ・サービス」の「トランスポート構成」ページで、「プロトコル」を「WS」に設定します。Service Busターゲットの「URL」設定と一致するように「エンドポイントURI」を設定します。「作成」をクリックします。

7. 新しいプロキシ・サービスの一般構成が表示されたプロキシ・サービス定義エディタが開きます。

4.4.2.2 Oracle Service Busコンソールでのプロキシ・サービスの作成

このプロセスの手順は次のとおりです。

1. Oracle Managed File TransferのWSDLファイルをOracle Service Busプロジェクトにインポートします。このファイルのフルパスは、WLS_Home/mft/integration/wsdl/ MFTAnyTypeService.wsdlです。

このファイルの詳細は、「MFT WSDLファイル」を参照してください。

Service Bus側の手順は、Oracle Service Busでのサービスの開発のリソースと構成のインポートおよびエクスポートに関する項を参照してください。

2. 「リソース」パネルで、プロキシ・サービスを追加するプロジェクトを選択し、「作成」アイコンの横にある下矢印をクリックします。

3. 「プロキシ・サービス」を選択して、「プロキシ・サービスの作成」ウィザードを表示します。

4. 「作成」ページの「サービスの作成」セクションで、プロキシ・サービスの名前を入力します。

5. 「作成」ページの「サービス定義」セクションで、「WSDLベース・サービス」を選択します。

6. 「検索」アイコンをクリックしてWSDLリソースを検索します。すべてのフィールドを空白にして、「検索」をクリックします。これにより、すべてのインポート済WSDLファイルが検索されます。検索結果表でOracle Managed File TransferのWSDLファイルを選択します。「OK」をクリックします。

7. WSDLファイルを指定したら、「ポート/バインド」フィールドから、使用するポートまたはバインディングを選択します。「次へ」をクリックします。

8. 「トランスポート」ページで、「プロトコル」を「WS」に設定します。Service Busターゲットの「URL」設定と一致するように「エンドポイントURI」を設定します。「作成」をクリックします。

9. 新しいプロキシ・サービスの一般構成が表示されたプロキシ・サービス定義エディタが開きます。

4.5 B2Bとの統合

B2Bは、Oracle Managed File Transferをリモート取引パートナとして認識します。B2Bは、外部デリバリ・チャネルを使用してOracle Managed File Transferにファイルを送信します。B2Bは、ファイルを受信するために特別な構成を必要としません。かわりに、Oracle Managed File TransferでB2Bドメインを構成します。

4.5.1 B2Bソースのリモート取引パートナ・チャネルの作成

Oracle Managed File TransferのB2Bソースは、B2Bのリモート取引パートナの外部デリバリ・チャネルに対応します。Oracle Managed File TransferでB2Bドメインを構成するか(「ドメインの管理」を参照)、B2Bでチャネルを構成します。

このプロセスの手順は次のとおりです。

1. B2Bの「パートナ」に移動します。

2. 「パートナ」ペインでリモート取引パートナを選択するか、新しいリモート取引パートナを作成します。

3. 「チャネル」タブを選択します。

4. 「名前」に新しいチャネルの名前を入力します。

5. 「プロトコル」ドロップダウン・リストで汎用MFT-1.0を選択します。

6. トランスポート制御パラメータ・タブで、次のパラメータを設定します。

- URL: Oracle Managed File Transferに接続するためのURL。

- ユーザー名: Oracle Managed File Transferに接続するためのユーザー名。

- 「パスワード」、「パスワードの確認」: Oracle Managed File Transferに接続するためのパスワード。

- ソース: Oracle Managed File TransferのB2Bソースの名前。

- 転送: B2Bソースに関連付けられている転送の名前。これはオプションです。

- ターゲット: B2Bソースに関連付けられているターゲットの名前。これはオプションです。

「ソース」は常に必須です。「URL」、「ユーザー名」および「パスワード」は、B2Bが別のサーバー上にあるOracle Managed File Transferに接続する必要がある場合にのみ必要です。

7. 「保存」をクリックします。

8. 外部デリバリ・チャネルは、Oracle Managed File Transferにファイルを送信する準備が整いました。

詳細は、Oracle B2Bユーザーズ・ガイドのチャネルの構成に関する項を参照してください。

4.5.2 B2BターゲットのB2Bドメインの構成

Oracle Managed File TransferのB2Bターゲットは、B2Bのホスト取引パートナのEJBをコールします。B2B構成は必要ありません。ただし、B2Bが同じ場所に配置されていない場合は、Oracle Managed File TransferでB2Bドメインを構成する必要があります。詳細は、「ドメインの管理」を参照してください。

4.5.3 連結されたB2BレポートとMFTレポート

B2BソースまたはターゲットのOracle Managed File Transferインスタンス・レポートには、「相関フローID」リンクが含まれています。このリンクをクリックすると、対応するB2Bインスタンスのビジネス・メッセージ・レポートが開きます。

同様に、Oracle Managed File TransferのB2Bビジネス・メッセージ・レポートの結果表の「フローのトレース」列には「MFTフロー」リンクが含まれています。このリンクをクリックすると、対応するOracle Managed File Transferインスタンスのレポートが開きます。

Oracle Managed File Transferインスタンスのレポートの詳細は、「ソース、転送およびターゲットのレポートの解釈」を参照してください。

4.6 Healthcareとの統合

Oracle SOA Suite for healthcare統合(Healthcare)は、Oracle Managed File Transferをリモートエンドポイントとして認識します。Healthcareは、アウトバウンド・エンドポイントを使用してOracle Managed File Transferにファイルを送信し、インバウンド・エンドポイントを使用してファイルを受信します。Oracle Managed File TransferでHealthcareドメインを構成する必要もあります。

HealthcareがMFTと同じ場所に配置されていない場合は、Oracle Managed File TransferでHealthcareドメインを構成する必要があります。詳細は、「ドメインの管理」を参照してください。

4.6.1 Healthcareソースのアウトバウンド・エンドポイントの作成

Oracle Managed File TransferのHealthcareソースは、Healthcareのリモート・エンドポイントのアウトバウンド・エンドポイントに対応します。

このプロセスの手順は次のとおりです。

1. Healthcareの「設計」タブの下の「構成」タブで、「エンド・ポイント」フォルダをクリックし、「作成」アイコンをクリックします。

2. 「作成」ウィンドウで、次を入力して「OK」をクリックします。

- 名前: 新しいエンドポイントの名前を入力します。

- トランスポート・プロトコル: 「MFT」を選択します。

- 方向: 「アウトバウンド」を選択します。

- ソース: MFTソース名を入力します。

Healthcareユーザー・インタフェースの右パネルにエンドポイントが表示されます。

3. 「ドキュメント・プロトコル」フォルダの下で転送するドキュメントを見つけます。

4. 転送するドキュメントを「送信するドキュメント」表にドラッグ・アンド・ドロップします。

5. エンドポイントを保存します。

詳細は、Oracle SOA Suite Healthcare Integrationユーザーズ・ガイドのエンドポイントの使用に関する項を参照してください。

4.6.2 Healthcareターゲットのインバウンド・エンドポイントの作成

Oracle Managed File TransferのHealthcareターゲットは、Healthcareのリモート取引パートナのインバウンド・エンドポイントに対応します。

このプロセスの手順は次のとおりです。

1. Healthcareの「設計」タブの下の「構成」タブで、「エンド・ポイント」フォルダをクリックし、「作成」アイコンをクリックします。

2. 「作成」ウィンドウで、次を入力して「OK」をクリックします。

- 名前: 新しいエンドポイントの名前を入力します。

- トランスポート・プロトコル: 「MFT」を選択します。

- 方向: 「インバウンド」を選択します。

Healthcareユーザー・インタフェースの右パネルにエンドポイントが表示されます。

3. 「トランスポートの詳細」ボタンをクリックします。

4. 「トランスポート・プロトコル・パラメータ」ウィンドウで、次を入力して「OK」をクリックします。

- ソース: MFTソース名を入力します。

- URL: MFTソースのURLを入力します。

- ユーザー名: MFTユーザー名を入力します。

- 「パスワード」、「パスワードの確認」: MFTユーザー名のパスワードを入力します。

エンドポイントが更新されます。

5. 「ドキュメント・プロトコル」フォルダの下で転送するドキュメントを見つけます。

6. 転送するドキュメントを「受信するドキュメント」表にドラッグ・アンド・ドロップします。

7. エンドポイントを保存します。

詳細は、Oracle SOA Suite Healthcare Integrationユーザーズ・ガイドのエンドポイントの使用に関する項を参照してください。

4.6.3 連結されたHealthcareレポートとMFTレポート

HealthcareソースのOracle Managed File Transferインスタンス・レポートには、「相関フローID」リンクが含まれています。このリンクをクリックすると、Healthcareエンドポイントの対応するレポートが開きます。

同様に、Oracle Managed File TransferのHealthcareエンドポイント・インスタンス・レポートには「MFTソース」アイコンまたは「MFTターゲット」アイコンが含まれています。このアイコンをクリックすると、対応するOracle Managed File Transferインスタンス・レポートが開きます。

Oracle Managed File Transferインスタンスのレポートの詳細は、「ソース、転送およびターゲットのレポートの解釈」を参照してください。

4.7 Oracle Data Integratorとの統合

Oracle Managed File Transferは、次の2つの方法でOracle Data Integrator (ODI)と統合できます。

- ファイル・システムを使用(ODIが同じ場所に配置されていない場合はFTPまたはsFTPを使用)。
ファイル・システムを使用する方法が最も簡単かつ一般的な統合方法です。

- Webサービスを使用(ODIソースの場合はOdiInvokeWebServiceツールを使用し、ODIターゲットの場合はデータ・サービスを構成する)。
Webサービス統合方法では、Oracle Data IntegratorがMFTと同じ場所に配置されていない場合はOracle Managed File TransferでODIドメインを構成する必要があります。詳細は、「ドメインの管理」を参照してください。

ファイル・システムを使用する方法は、大きなファイルやバッチ処理に最も適しています。一方、Webサービスを使用する方法は、更新やトリクル・フィードのより小さいペイロードに適しています。

4.7.1 ODI統合でのファイル・システムとFTPの使用

ODI統合にファイル・システムを使用する場合は、ODIソース・タイプまたはターゲット・タイプを使用しません。手順は次のとおりです。

ODIからMFTへ: ODIは、自身のファイルまたはFTPアダプタを使用してMFTファイル、FTPリモート、sFTPリモート、FTP埋込みまたはsFTP埋込みソースの場所にペイロードをコピーします。MFTは次に、1つ以上のターゲットにペイロードを転送します。

MFTからODIへ: MFTは、ペイロードをファイル、FTPリモートまたはsFTPリモート・ターゲットに転送します。ODIは、自身のファイルまたはFTPアダプタを使用して、MFTターゲットの場所からファイルを読み取ります。

これらのODI転送は次のようなMFT機能を使用できます。

- 前処理(暗号化、復号化、ペイロードを変更するカスタム・コールアウトなど)

- スケジュール

- 再送信

4.7.2 ODIソースのWebサービスの起動

Oracle Managed File TransferのODIソースは、ODIがOdiInvokeWebServiceツールを使用して起動できるWebサービスとして公開されます。

ODIソースの使用には次の制限があります。

- MFTは同期起動をサポートしていません。

- MFTがODIに送信するレスポンスにはMFTメッセージIDのみが含まれています。

- MFTは転送が成功したかどうかをODIに通知しません。
ただし、通知を送信するためのカスタム・コールアウトを作成できます。詳細は、「カスタム・コールアウトによる転送の処理」を参照してください。

このプロセスの手順は次のとおりです。

1. MFTで、ODIソースを作成し、その場所のURLを入力します。

2. ODIのデザイナ・ナビゲータの「プロジェクト」ツリーで、ファイルをMFTに送信するプロジェクトとパッケージを選択します。

3. パッケージにOdiInvokeWebServiceツールのステップを作成し、それを選択します。

4. 「プロパティ」の下の「一般」タブをクリックします。

5. 次のパラメータの値を指定します。

- WSDL URL: MFT ODIソースのWSDLファイルのURLを指定します。これは、?WSDL接尾辞を付けたODIソースURLです。次に例を示します。

http://www.example.com:7001/mftapp/services/transfer/odi-src-name?WSDL

詳細は、「MFT WSDLファイル」を参照してください。

- ポート・タイプ: MFTServicePortTypeを指定します。

- 操作: submitを指定します。

- XMLリクエスト: SOAPヘッダーと転送するファイルを含むWebサービス・ペイロードを入力します。

6. 「ファイル」→「保存」を選択し、パッケージを保存します。

詳細は、Oracle Data Integratorによるデータ統合の開発のOdiInvokeWebServiceツールの使用方法に関する項を参照してください。

4.7.3 ODIターゲットのデータ・サービスの作成

Oracle Managed File TransferのODIターゲットは、ODIのデータ・サービスに対応します。ODIデータ・サービスは、データストア内のデータへのアクセスを提供する専用のWebサービスです。ODIはこれらのデータ・サービスを生成して、Oracle WebLogic ServerのWebサービス・コンテナにデプロイします。

ODIターゲットの使用には次の制限があります。

- MFTソースからの入力は、ODIデータ・サービス・スキーマに準拠する必要があります。

- メッセージ・タイプはXMLで、ODI WSDL形式と一致する必要があります。MFTは、この検証を実行できません。

- MFTは、同期メッセージングをサポートしていません。

- MFTは、ODIデータ・サービスによって公開されたデータにアクセスできません。

- 「添付」の「ペイロード・タイプ」と「参照による」の「配信方法」はサポートされていません。

- 大きなファイルではなく、小さいペイロードをお薦めします。

このプロセスの手順は次のとおりです。

1. ODIのデザイナ・ナビゲータの「モデル」ツリーで、データストアが含まれているモデルを選択します。

2. そのモデルをクリックして、編集します。

3. 「サービス」を選択します。

4. 次のプロパティに値を指定します。

- アプリケーション・サーバー: Oracle WebLogic Serverのホストとポートを指定します。次に例を示します。

localhost:7003

- ネームスペース: 次のようにMFTネームスペースを指定します。

http://xmlns.oracle.com/fmw/mft/soap

- パッケージ名: 次のようにパッケージ名を指定します。

com.oracle.mft

- データ・ソースの名前: データ・ソース名を入力します。

- データ・サービスの名前: データ・サービス名を入力します。

- アクティブ: Webサービスとして公開するデータストアの横の「アクティブ」ボックスを選択します。
「Webサービス名」と「公開済エンティティ」を書き留めます。これらの情報は、MFTターゲットを構成するときに必要になります。

5. 「ファイル」→「保存」を選択し、モデルを保存します。

詳細は、Oracle Data Integratorの管理のデータ・サービスの生成およびデプロイに関する項を参照してください。

データ・サービスがOracle WebLogic Serverでデプロイされると、MFT ODIターゲットはデータ・サービスによって公開される変更操作を起動できます。

このプロセスの手順は次のとおりです。

1. MFTで、タイプODIのターゲットを作成します。

2. MFTターゲットURLとしてデータ・サービスURLを指定します。次に例を示します。

http://www.example.com:15101/model-name/web-svc-name

3. 「拡張プロパティ」の左にある矢印をクリックして、プロパティを表示します。

4. 次のプロパティに値を指定します。

- サービス: ODIモデルの「Webサービス名」を指定します。

- ポート: ポートを指定します。デフォルトでは、これは、SoapPort接尾辞が付いたWebサービス名です。

- アクション: 転送されたファイルの取得に使用するWebサービス・メソッドを指定します。デフォルトでは、これはadd接頭辞とList接尾辞を持つ、ODIモデルからの公開済エンティティです。
Webサービス情報は、Oracle WebLogic ServerまたはOracle Enterprise Manager Fusion Middleware Controlで表示できます。詳細は、Oracle WebLogic Server JAX-WS Webサービスの開発のJAX-WS Webサービスの開発に関する項を参照してください。

- ペイロード・タイプ: 「インライン」を選択します。

- メッセージ・タイプ: 「Xml」を選択します。

5. ターゲットを「保存」します。

6. ターゲットを転送に追加します。

7. 転送構成で、「配信プリファレンス」の左にある矢印をクリックしてオプションを表示します。

8. 「配信方法」として「インライン」を選択します。

9. 転送を保存してデプロイします。

4.8 Webサービスとの統合

Webサービスと統合できるアプリケーションはすべて、Oracle Managed File Transferと統合できます。タイプがSOAPのソースおよびターゲットは、標準Webサービス・エンドポイントとして公開されます。Oracle Managed File Transferで指定するソース設定とターゲット設定は統合アプリケーションで指定する設定でもあるため、統合アプリケーションはソースまたはターゲットを認識できます。

MFTAnyTypeService.wsdlファイルは、Webサービスと統合するすべてのアプリケーション・タイプ用です。詳細は、「MFT WSDLファイル」を参照してください。

Webサービスとの詳細は、Webサービスの理解のOracle Fusion Middleware 12cのWebサービスの概要に関する項を参照してください。

4.9 MFT WSDLファイル

Oracle Managed File Transferには、統合アプリケーションがOracle Managed File TransferとのWebサービス・インタフェースの作成に使用できるWSDLファイルが用意されています。これらのファイルは、WLS_Home/mft/integration/wsdlにあります。表4-2でこれらのファイルを説明します。

表4-2 MFT WSDLファイル

WSDLファイル名

目的

操作

使用方法

MFTAnyTypeService.wsdl

MFT SOAPソースおよびターゲットで使用されます。一般メッセージなどのSOAPメッセージを受け入れます。

submitReference

submitInline

どちらの操作もMFTメッセージIDやその他のトラッキング・パラメータで応答します。

submitReferenceの場合、SOAP本文のMFTServiceInput要素にFTPまたはFILE参照が必要です。TargetFileNameとcontentIdentifierはオプションです。

submitInlineの場合は、ペイロードはSOAP本文に直接埋め込まれた有効なXMLコードにできます。

MFTService.wsdl

MFT SOAソースおよびターゲットで使用されます。SOAメッセージを受け入れます。

submit

メッセージIDやその他のトラッキング・パラメータで応答します。

SOAP本文のMFTServiceInput要素にFTPまたはFILE参照かインライン・ペイロードまたはバイナリ・ペイロードが必要です。TargetFileNameとcontentIdentifierはオプションです。

MFTSOAService.wsdl

Oracle JDeveloper統合の抽象WSDL。MFT参照WSDLの作成に使用されます。

submit

メッセージIDやその他のトラッキング・パラメータで応答します。

MFTService.wsdlと同じです。

MFTDiscoveryService.wsdl

Oracle JDeveloperによってすべてのMFT SOAソースの問合せに使用されます。MFT SOAソースの選択時、MFT SOA参照の設計時およびSOAコンポジット・アプリケーションのビルド時に使用されます。

getSources

タイプと一致するソースのリストで応答します。

SOAP本文のMFTServiceInput要素にソース・タイプを表す単一文字列パラメータが必要です。MFTServiceInputの可能な値は、SOAP、SOA、OSB (Service Busの場合)またはODIです。

MFTResubmitService.wsdl

MFTソース・インスタンス・メッセージ、転送インスタンス・メッセージおよびターゲット・インスタンス・メッセージの再送信のサポートに使用されます。

resubmitMessage

成功または失敗を示すtrueまたはfalseで応答します。

必須の入力パラメータは、MessageTypeとMessageIDです。MessageTypeの可能な値は、SOURCE、TARGETまたはTRANSFERです。ユーザー・コメントはオプションです。

これらのWSDLファイルのヘッダーは、「監視」ページからアクセスできる転送のソース・レポートおよびターゲット・レポートに表示されます。これらのレポートの詳細は、「ソース、転送およびターゲットのレポートの解釈」を参照してください。WSDLファイル・ヘッダーの詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプのソース・プロトコル・ヘッダーに関する項とターゲット・プロトコル・ヘッダーに関する項を参照してください。

MFT WSIL URLは次のとおりです。

http://host:port/inspection.wsil/?appname=mft-app

MFT検出サービスURLは次のとおりです。

http://host:port/mftapp/services/MFTDiscoveryService?WSDL

注意:

一部のSOAPクライアントは、MFTがペイロードとして解釈し、転送されるファイルに追加するinputタグを自動的にWSDLファイルに生成します。このタグが必要ない場合は、削除できます。

注意:

WSDLファイルにMFTServicePortの有効な値を必ず含めてください。有効な値が含まれていないと、次のエラー・メッセージが表示されることがあります。

oracle.jdeveloper.webservices.model.WebServiceException: Service MFTService_soap contains no SOAP ports and cannot be used.

5 Oracle Managed File Transferの監視

この章では、Oracle Managed File Transferコンソールの「監視」ページについて説明します。このページには、ソース、ターゲットおよび転送のアーティファクトのデプロイメントに関する情報が表示されます。このページにはダッシュボードもあり、すべてのアーティファクト、特定のタイプ(ソース、転送またはターゲット)のすべてのアーティファクトまたは個々のアーティファクトのデータが表示されます。ダッシュボードでは、進行中および完了したファイル転送インスタンスの情報を得ることができます。

この章の内容は次のとおりです。

- デプロイ済のソース、ターゲットおよび転送の監視

- メイン・ダッシュボードを使用した転送フローの監視

- すべての転送、ソースまたはターゲットのダッシュボードの解釈

- 単一アーティファクトの転送、ソースおよびターゲットのダッシュボードの解釈

- ソース、転送およびターゲットのレポートの解釈

- 転送の一時停止と再開

- 転送の再送信

- ファイル配信失敗の診断

- 転送エラーの診断

5.1 デプロイ済のソース、ターゲットおよび転送の監視

ソース、転送またはターゲットのアーティファクトをデプロイした後は、そのアーティファクトを「監視」ページの「デプロイメント」タブで見ることができます。どのアーティファクトを見るかを選択できます。

- 「ソート順」で、デプロイ時間、更新された時間、名前またはアーティファクト・タイプの昇順または降順にソートします。

- 「デプロイ」または「更新日」と「起点」または「至」の日付および時刻を使用して、範囲を選択します。

- 「選択」、「選択解除」またはすべて反転。反転とは、未選択のアーティファクトを選択して選択済アーティファクトの選択を解除することです。

- 次のみ表示: 「ソース」、「ターゲット」または「転送」。特定のタイプのみの表示も、すべてのタイプの表示もできます。

- 「デプロイメントの詳細の表示」では、選択されているアーティファクトのラベルと依存アーティファクトが表示されます。ラベルとは、Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーでの、アーティファクトに対応するデプロイメントの名前です。同じ転送に関連付けられているアーティファクトは、相互依存関係にあります。

注意:

「作成」のタイムスタンプは、アーティファクトではなくラベルの作成を指します。アーティファクトを編集して再デプロイすると、新しいラベルが作成されます。

これらの選択に基づいて表示をリフレッシュするには、「フィルタ」または「実行」アイコンをクリックします。「実行」アイコンは、これらの選択を変更したときに表示されます。これらの選択を解除してデフォルト値に従って表示するには、消去アイコンをクリックします。

5.1.1 ソース、ターゲットおよび転送の無効化

デプロイされるアーティファクトはすべて、デフォルトで有効化されます。アーティファクトを無効化すると、アンデプロイせずに非アクティブ状態になります。

このプロセスの手順は次のとおりです。

1. アーティファクトの左にあるチェック・ボックスを選択します。

2. 「無効化」ボタンをクリックします。
「デプロイメントの無効化」ダイアログに、無効化の影響を受ける依存アーティファクトが表示されます。必要に応じてコメントを入力できます。

3. 「はい」ボタンをクリックします。
「デプロイメントの無効化」ダイアログに、無効化に成功したかどうかが表示されます。

4. 「OK」ボタンをクリックします。
無効化に成功した場合は、そのアーティファクトの「ステータス」列の内容が緑色の「有効」から赤色の「無効」に変化します。依存アーティファクトも、無効と表示される可能性があります。

5.1.2 ソース、ターゲットおよび転送の再有効化

無効化したアーティファクトを再び有効化できます。

このプロセスの手順は次のとおりです。

1. アーティファクトの左にあるチェック・ボックスを選択します。

2. 「有効化」ボタンをクリックします。

「デプロイメントの有効化」ダイアログが表示されます。必要に応じてコメントを入力できます。

3. 「はい」ボタンをクリックします。

「デプロイメントの有効化」ダイアログに、有効化に成功したかどうかが表示されます。

4. 「OK」ボタンをクリックします。

有効化に成功した場合は、そのアーティファクトの「ステータス」列の内容が赤色の「無効」から緑色の「有効」に変化します。

注意:

依存アーティファクトが無効化されていた場合は、そのアーティファクトの再有効化を別に行う必要があります。たとえば、ソースを無効化し、そのソースに関連付けられた転送が無効化された場合に、ソースを再有効化しても転送が再有効化されることはありません。

5.1.3 ソース、ターゲットおよび転送のアンデプロイ

アーティファクトの非アクティブ化と編集を同時に行う必要がある場合は、無効化よりもアンデプロイのほうが好ましい可能性があります。Oracle Managed File Transferによって、アーティファクト(ソース、転送およびターゲット)のバージョンが保持されます。アーティファクトをデプロイする場合、その現在のバージョンがデプロイされます。これらのバージョンは、将来の監査用に保存されています。アーティファクトをアンデプロイすると、次のようになります。

- そのアーティファクトは、WLSTコマンドによるパージの対象となります(「Oracle Managed File Transferのユーティリティ」を参照)。

- そのバージョンを再度デプロイすることはできません。前のバージョンに戻すことはできません。

このプロセスの手順は次のとおりです。

1. アーティファクトの左にあるチェック・ボックスを選択します。

2. 「アンデプロイ」ボタンをクリックします。

デプロイメントの削除ダイアログが表示されます。必要に応じてコメントを入力できます。

3. 「はい」ボタンをクリックします。

デプロイメントの削除ダイアログに、アンデプロイに成功したかどうかが表示されます。

4. 「OK」ボタンをクリックします。

アンデプロイに成功した場合は、そのアーティファクトが「デプロイメント」タブから削除されます。

注意:

ソースまたはターゲットに関連付けられている転送がデプロイ済の場合は、そのソースまたはターゲットのアンデプロイはできません。「アンデプロイ」ボタンはグレー表示のままとなります。

5.1.4 ソース、ターゲットおよび転送の再デプロイ

アーティファクトを再デプロイするには、「設計」ページでそのタブを開いて「デプロイ」をクリックします。「ソース、ターゲットまたは転送のデプロイ」を参照してください。

5.1.5 ソース、ターゲットおよび転送のバージョニング

Oracle MFTは、MDSを使用してメタデータを格納します。MDSリポジトリでは、ドキュメントのバージョンがデータベース・ベース・リポジトリに保持されます。バージョニングを使用すると、メタデータ・オブジェクトに対する変更は、メタデータ・リポジトリの既存データを単に上書きするのではなく、別のバージョンとして保存されます。バージョンのラベル付けだけではなくバージョン履歴の機能もあるため、特定時点におけるメタデータのセットを取得できます。アーティファクトはデプロイメント後に変更できますが、新しいバージョンがデプロイされるまで、実行時には元のバージョンが使用されます。最新の変更をアクティブにして適用するには、アーティファクトを再デプロイする必要があります。

WLSTコマンドを使用して、次に示すMDSリポジトリの操作を実行できます。

- すべてのデプロイメント履歴をリストするために使用するgetSourceDeploymentHistory 。

- デプロイされたバージョンのアーティファクトをエクスポートするために使用するexportDeployedArtifact。

- 古いデプロイメント履歴を削除するために使用するdeleteArtifactDeployment 。

MDSリポジトリの使用の詳細は、Oracle Fusion Middlewareの管理のメタデータ・リポジトリの管理を参照してください。

5.2 メイン・ダッシュボードを使用した転送フローの監視

「監視」ページの「ダッシュボード」タブは、常に開いています。メイン・ダッシュボードには、リアルタイムおよび最近実行されたファイル配信のデータが、4つのビューで表示されます。

- メトリック: 「メイン・ダッシュボードのメトリックの解釈」を参照してください。

- ファイル・ファインダ: 「ファイル・ファインダの使用」を参照してください。

- 最新のエラー: 「転送エラーの診断」を参照してください。

- アクティブな配信: 「アクティブな配信の監視」を参照してください。

各ビューを開いてタブ全体に表示するには、右上にある「展開」アイコンをクリックします。ビューを閉じてメイン・ダッシュボードに戻るには、開いた状態のビューの右上にある「復元」アイコンをクリックします。

「設計」ページと「デプロイメント」タブには、ソース、転送およびターゲットのアーティファクトが表示されます。アーティファクトとは、ファイル配信をどのように行うかを構造化したものです。対照的に、メイン・ダッシュボードにはソース、転送およびターゲットのインスタンスが表示されます。インスタンスとは、個々のファイル配信そのもののことです。

5.2.1 メイン・ダッシュボードのメトリックの解釈

「メトリック」ビューには、最近実行された転送の様々な統計が表示されます。これらの統計を使用すると、使用頻度の高い転送や、失敗した転送、あるいは完了までに時間がかかっている転送を特定できます。

「最近」の範囲を指定するには、時間の長さを表すこれらの値の1つを「データの表示」ドロップダウン・リストで選択します。

- 過去1時間

- 過去6時間

- 過去24時間(デフォルト)

- 過去3日間

- 先週

開いていない状態のビューに表示される統計は次のとおりです。

- 転送: 「合計」、「完了」、「アクティブ」および「失敗」

- 最もアクティブな転送: 選択された期間中のインスタンス数が最大である転送

- ステータス: 完了した転送、アクティブな転送、失敗した転送の円グラフ

- 失敗率: 失敗した転送の割合(%)

- ペイロード・ファイル・サイズ: 「平均」、「最小」および「最大」(バイト単位)

- 転送スピード: 「平均」、「最小」および「最大」(バイト/秒)

- 合計時間: 「平均」、「最小」および「最大」(ミリ秒)

開いた状態のビューでは、次の列を持つ「すべての転送」表が追加されます。

- 転送: 名前をクリックすると転送レポートが開きます。「転送レポート」を参照してください。

- リフレッシュ: ページをリフレッシュして更新後のデータを反映します。

- 消しゴムのアイコン: 転送の表での選択を解除します。このアイコンが有効になるのは、円グラフのセクションがクリックされた結果として転送の表が表示された場合です。

- ソート基準: ステータスと名前のどちらでソートするかを選択します。

- ソース: 転送に関連付けられているソース。名前をクリックするとソース・レポートが開きます。「ソース・レポート」を参照してください。

- ステータス: 「アクティブ」、「失敗」、または「完了」

- サブステータス: 転送のサブステータス。「アクティブ」のサブステータスは次のとおりです。

- 配信進行中

- 進行中

- 一時停止中

- 保留中

- 配信保留中

- 後処理

- 前処理

- 再試行中

- スケジュール済

「失敗」のサブステータスは次のとおりです。

- エラー

- 部分エラー

- 後処理

- 前処理

「完了」のサブステータスは「正常終了」のみです。

- 開始時間: 転送が開始した日時

- コンテンツ・タイプ: 転送されるファイルのタイプ(例: XML)。コンテンツ・タイプはコンテンツ・フィルタで定義します。「コンテンツ・フィルタの設定」を参照してください。

5.2.2 ファイル・ファインダの使用

「ファイル・ファインダ」ビューの表では、転送インスタンスを検索できます。検索条件として、関連付けられたファイル、ソース、またはターゲットの名前を使用します。

開いていない状態のビューでは、ファイル名とソースまたはターゲットの名前の一方または両方で検索できます。検索時に英字の大文字と小文字が区別され、「次で始まる」演算子が使用されます。ワイルド・カードとして%を使用できます。表の列は次のとおりです。

- 「ソース」または「ターゲット」: 名前をクリックすると、ソースまたはターゲットのレポートが開きます。「ソース・レポート」または「ターゲット・レポート」を参照してください。

- ステータス: 「アクティブ」、「失敗」、または「完了」

- 作成時間: ファイルがソースまたはターゲットの場所に書き出された日時。

- ファイル: 転送されたファイルの名前。ファイルの名前はターゲット側で変更されることもあります。「配信後のファイルの移動と名前変更」を参照してください。

- サイズ: 転送されたファイルのサイズ(バイト単位)。圧縮や暗号化によって、ターゲット側でファイルのサイズが変化する可能性があります。「ソース処理アクションの設定」および「転送の前処理と後処理のアクションの設定」を参照してください。

開いた状態のビューでは、次の機能が追加されます。

- 演算子を選択可能: 「次で始まる」、「完全一致」、「次を含む」

- 「大/小文字の区別」チェック・ボックス

- 検索パラメータをすべて消去するためのアイコン

- 次の2つの列が表に追加されます。

- タイプ: 取り得る値は「B2B」、「SOA」、「Healthcare」、「OSB」、「ODI」、「ソース再送信」および「外部」です。

- 送信者: 転送を開始したユーザーの名前

- 各列の検索フィールド

注意:

後処理は、ファイル配信の後に実行されます。したがって、ファイル配信に成功しても後処理に失敗した場合は、「アクティブな配信」ビューと「ファイル・ファインダ」ビューに表示されるステータスは異なります。具体的には、「アクティブな配信」ビューでは「完了」ステータスが表示されますが、「ファイル・ファインダ」ビューでは「失敗」ステータスが表示されます。

5.2.3 アクティブな配信の監視

「アクティブな配信」ビューは、開いていない状態でも開いた状態でも同じです。最近実行された、および進行中の配信について、次の情報が表示されます。

- 転送名: 名前をクリックすると、転送レポートが開きます。「転送レポート」を参照してください。

- 開始時間: 転送が開始した日時。

- 進行状況: 完了率(%)。進行状況が100%未満で変化しない場合は、転送が一時停止しているか失敗したことを示している可能性があります。「転送の一時停止と再開」または「転送エラーの診断」を参照してください。

- リフレッシュ: アクティブな配信をリフレッシュする間隔を選択します。

5.3 すべての転送、ソースまたはターゲットのダッシュボードの解釈

ソース、転送またはターゲットのダッシュボードには、リアルタイムの、および最近実行されたファイル配信(インスタンスといいます)のデータのうち、同じタイプのすべてのアーティファクトに関連するものが表示されます。メイン・ダッシュボードとは異なり、「すべてのアーティファクト」のダッシュボードは開く必要があります。左ペインのナビゲータの「転送インスタンス」、「ソース・インスタンス」または「ターゲット・インスタンス」をクリックします。

アーティファクト・ダッシュボードのビューは次のとおりです。

- メッセージ: 「インスタンス・メッセージの解釈」を参照してください。

- サマリー統計: 「ダッシュボード・メトリックの解釈」を参照してください。

メイン・ダッシュボードのビューとは異なり、アーティファクト・ダッシュボードのビューには「展開」アイコンはありません。

5.3.1 インスタンス・メッセージの解釈

「メッセージ」ビューは、ダッシュボードを開くときに選択されたタイプのすべてのアーティファクトのファイル配信インスタンス・メッセージの表であり、検索可能です。ワイルド・カードとして%を使用できます。この表に表示されるものは次のとおりです。

- ID: 「ID」のリンクをクリックすると、単一アーティファクトのソース、転送またはターゲット・ダッシュボードが開きます。「単一アーティファクトの転送、ソースおよびターゲットのダッシュボードの解釈」を参照してください。

- 名前: アーティファクトの名前。

- ステータス: 「アクティブ」、「失敗」、または「完了」。「アクティブ」のサブステータスは次のとおりです。

- 配信進行中

- 進行中

- 一時停止中

- 保留中

- 配信保留中

- 後処理

- 前処理

- 再試行中

- スケジュール済

「失敗」のサブステータスは次のとおりです。

- エラー

- 部分エラー

- 後処理

- 前処理

「完了」のサブステータスは「正常終了」のみです。

- URI: ソースの場所のURI (ソース・ダッシュボードのみにあります)。

- タイプ: ソースまたはターゲットのタイプ(ソースとターゲットのダッシュボードのみにあります)。

- 作成時間: ファイルがソースまたはターゲットの場所に書き出された日時。

5.3.2 ダッシュボードのメトリックの解釈

「サマリー統計」ビューには、ダッシュボードが開くときに選択されたアーティファクト・タイプに関連する、最近実行された転送の様々な統計が表示されます。これらの統計を使用すると、これらの転送の使用頻度が高いかどうか、失敗したかどうか、あるいは完了までに時間がかかっているかどうかを特定できます。

「最近」の範囲を指定するには、時間の長さを表すこれらの値の1つを「データの表示」ドロップダウン・リストで選択します。

- 過去1時間

- 過去6時間

- 過去24時間(デフォルト)

- 過去3日間

- 先週

表示される統計は次のとおりです。

- 転送: 「合計」、「完了」、「アクティブ」および「失敗」

- ステータス: 完了した転送、アクティブな転送、失敗した転送の円グラフ

- 最もアクティブなアーティファクト: アクティブさの点で上位にある転送、ソースまたはターゲットの名前。

- 失敗率: 失敗した転送の割合(%)

- ペイロード・ファイル・サイズ: 「平均」、「最小」および「最大」(バイト単位)

- 転送スピード: 「平均」、「最小」および「最大」(バイト/秒)

- 合計時間: 「平均」、「最小」および「最大」(ミリ秒)

5.4 単一アーティファクトの転送、ソースおよびターゲットのダッシュボードの解釈

単一アーティファクトのソース、転送またはターゲットのダッシュボードには、リアルタイムの、および最近実行されたファイル配信(インスタンスといいます)のうち、特定のアーティファクトに関連するもののデータが表示されます。メイン・ダッシュボードとは異なり、アーティファクトのダッシュボードは開く必要があります。

このプロセスの手順は次のとおりです。

1. 左ペインのナビゲータの「転送インスタンス」、「ソース・インスタンス」または「ターゲット・インスタンス」の左にある矢印をクリックします。
そのタイプのアーティファクトが一覧表示されます。

2. アーティファクト名をクリックするか右クリックし、「開く」というメニュー項目を選択します。
そのアーティファクトのダッシュボード・タブが開きます。

アーティファクト・ダッシュボードのビューは次のとおりです。

- メッセージ: 「アーティファクト・インスタンス・メッセージの解釈」を参照してください。

- アーティファクト情報: 「アーティファクト情報の解釈」を参照してください。

- サマリー統計: 「アーティファクト・ダッシュボード・メトリックの解釈」を参照してください。

メイン・ダッシュボードのビューとは異なり、アーティファクト・ダッシュボードのビューには「展開」アイコンはありません。

5.4.1 アーティファクト・インスタンス・メッセージの解釈

「メッセージ」ビューは、ダッシュボードを開くときに選択されたアーティファクトのファイル配信インスタンス・メッセージの表であり、検索可能です。ワイルド・カードとして%を使用できます。この表に表示されるものは次のとおりです。

- レポート: レポート・リンクをクリックすると、ソース、転送またはターゲットのレポートが開きます。「ソース・レポート」、「転送レポート」または「ターゲット・レポート」を参照してください。

- ファイル名: 転送されたファイルの名前。ファイルの名前はターゲット側で変更されることもあります。「配信後のファイルの移動と名前変更」を参照してください。

- サイズ: 転送されたファイルのサイズ(バイト単位)。圧縮や暗号化によって、ターゲット側でファイルのサイズが変化する可能性があります。「ソース処理アクションの設定」および「転送の前処理と後処理のアクションの設定」を参照してください。

- 作成時間: ファイルがソースまたはターゲットの場所に書き出された日時。

- ステータス: 「アクティブ」、「失敗」、または「完了」。「アクティブ」のサブステータスは次のとおりです。

- 配信進行中

- 進行中

- 一時停止中

- 保留中

- 配信保留中

- 後処理

- 前処理

- 再試行中

- スケジュール済

「失敗」のサブステータスは次のとおりです。

- エラー

- 部分エラー

- 後処理

- 前処理

「完了」のサブステータスは「正常終了」のみです。

5.4.2 アーティファクト情報の解釈

アーティファクト情報ビューには、ダッシュボードが開くときに選択されたアーティファクトの、次に示す情報が表示されます(該当するもののみ)。ソースの場合は、参照している転送に関する情報も表示されます。転送の場合は、参照されているソースとターゲットに関する情報も表示されます。

- 名前: アーティファクト名。

- カテゴリ: アーティファクトのカテゴリ。

- URI: ソースまたはターゲットのエンドポイントの場所。

- バインディング・タイプ: ソースまたはターゲットのタイプ。「ソース・タイプ」および「ターゲット・タイプ」を参照してください。

- デプロイ: そのアーティファクトがデプロイ済かどうかをtrueまたはfalseで表します。「ソース、ターゲットまたは転送のデプロイ」を参照してください。

- ラベル: Oracle Managed File Transfer専用Oracle WebLogic Server上での、デプロイされたアーティファクトの名前。

- ステータス: デプロイされたアーティファクトが「有効」か「無効」かどうか。「ソース、ターゲットおよび転送の無効化」および「ソース、ターゲットおよび転送の再有効化」を参照してください。

- バージョン: アーティファクトのバージョン。

- 作成時間: アーティファクトが作成された日時。

ダッシュボードを開くときに選択されたアーティファクトを、「デザイナ」ページのタブの1つとして開くには、「定義の表示」をクリックします。「ソースの作成」、「ターゲットの作成」または「転送の構成」を参照してください。

5.4.3 アーティファクト・ダッシュボードのメトリックの解釈

「サマリー統計」ビューには、ダッシュボードを開くときに選択されたアーティファクトに関連する、最近実行された転送に関する様々な統計が表示されます。これらの統計を使用すると、これらの転送の使用頻度が高いかどうか、失敗したかどうか、あるいは完了までに時間がかかっているかどうかを特定できます。

「最近」の範囲を指定するには、時間の長さを表すこれらの値の1つを「データの表示」ドロップダウン・リストで選択します。

- 過去1時間

- 過去6時間

- 過去24時間(デフォルト)

- 過去3日間

- 先週

表示される統計は次のとおりです。

- 転送: 「合計」、「完了」、「アクティブ」および「失敗」

- ステータス: 完了した転送、アクティブな転送、失敗した転送の円グラフ

- 失敗率: 失敗した転送の割合(%)

- ペイロード・ファイル・サイズ: 「平均」、「最小」および「最大」(バイト単位)

- 転送スピード: 「平均」、「最小」および「最大」(バイト/秒)

- 合計時間: 「平均」、「最小」および「最大」(ミリ秒)

5.5 ソース、転送およびターゲットのレポートの解釈

レポートには、特定のファイル配信インスタンスにおけるソース、転送またはターゲットの関与に関する詳細な情報が表示されます。レポートには、次の場所からアクセスできます。

- 開いた状態の「メトリック」ビューの「すべての転送」の表の「転送」または「ソース」列。「メイン・ダッシュボードのメトリックの解釈」を参照してください。

- 「ファイル・ファインダ」ビューの「ソース」または「ターゲット」列。「ファイル・ファインダの使用」を参照してください。

- 「アクティブな配信」ビューの「転送名」列。「アクティブな配信の監視」を参照してください。

- ソース、転送またはターゲットのダッシュボードの「メッセージ」ビューにある「レポート」リンク。「アーティファクト・インスタンス・メッセージの解釈」を参照してください。

- 別のレポート。「フロー・ダイアグラムの使用」、「ソース・レポート」、「転送レポート」および「ターゲット・レポート」を参照してください。

転送に対する操作をレポートから実行することもできます。「転送の一時停止と再開」および「転送の再送信」を参照してください。

5.5.1 フロー・ダイアグラムの使用

ソース、転送、ターゲットのレポートの先頭には必ずフロー・ダイアグラムがあります。この図には、生成されたレポートの対象であるファイル配信インスタンスに関連するアーティファクトがすべて表示されます。図5-1に、典型的なフロー・ダイアグラムを示します。

図5-1 フロー・ダイアグラム

ソースが強調されているのは、このフロー・ダイアグラムがソース・レポートのものであることを示しています。転送やターゲットのアイコンをクリックすると、その転送またはターゲットのレポートに移動できます。各アーティファクトに緑色のチェックマークがあり、ファイル配信の各段階が正常終了したことを示しています。

アーティファクトの右にある下向き矢印は、ファンアウトを示します。転送のターゲットが複数ある場合は、そのフロー・ダイアグラムのターゲットのところにファンアウトが表示されます。図5-2では、転送のところにファンアウトが表示されています。これは、複数の転送で同じソースが使用されていることを示します。

図5-2 ファンアウトのあるフロー・ダイアグラム

ソース・アイコンのところにある緑色の歯車のアイコンは、前処理アクション(圧縮や暗号化など)がソースにおいて実行中であることを示します。

ファンアウトの中のすべてのアーティファクトのリストを表示するには、図5-3に示すように下向き矢印をクリックします。このリストから選択して、そのアーティファクトのレポートに移動できます。

図5-3 ファンアウト・リストのあるフロー・ダイアグラム

フロー・ダイアグラムには、警告、エラーおよび再送信試行が表示されることもあります。図5-4に示すフロー・ダイアグラムは、ソースにおいて再送信されたファイル配信インスタンスのものです。

図5-4 再送信、警告およびエラーのアイコンのあるフロー・ダイアグラム

ソース・アイコンのところにある、黒色の矢印の付いた緑色の円は、再送信が行われたことを示しています。感嘆符付きの黄色の三角形は、ソースと転送において警告が発生したことを示します。感嘆符付きの赤色の円は、ターゲットにおいてエラーが発生したことを示します。

5.5.2 ソース・レポート

ソース・レポートには次のセクションがあります。

- フロー表示とコントロール: フロー・ダイアグラム、「リフレッシュ」ボタン、レポートのタイトル、およびソースの再送信ボタン

- サマリー: ファイル名、ソースの場所、ペイロードのサイズ、再送信回数などの基本的情報

- エラー: エラー・コード、レベル、カテゴリ、インスタンスID、タイムスタンプ、説明などの、エラーに関する情報(エラーが発生した場合)

- 再送信済インスタンス: インスタンスID、ユーザー・コメント、ユーザー名、タイムスタンプなどの、ソース再送信に関する情報(再送信が行われた場合)

- 転送インスタンス: ソースに関連付けられている転送に関する情報。転送名をクリックすると、転送のレポートに移動できます。

- ソース処理: 前処理アクション(圧縮、圧縮解除、暗号化など)に関する情報

- 拡張: あまりアクセスされない情報(ソース・ラベルや内部IDなど)

- セキュリティ: セキュリティに関連する情報(該当する場合)。アルゴリズム、証明書、暗号化などです。

ソース・レポートに表示される情報の詳しい説明は、Oracle Fusion Middleware MFT Composerヘルプ・オンライン・ヘルプのソース・レポートに関する項を参照してください。

5.5.3 転送レポート

転送レポートには次のセクションがあります。

- フロー表示とコントロール: フロー・ダイアグラム、「リフレッシュ」ボタン、レポートのタイトル、および転送の再送信ボタン

- サマリー: ファイル名、ステータス、再送信回数などの基本的情報

- エラー: エラー・コード、レベル、カテゴリ、インスタンスID、タイムスタンプ、説明などの、エラーに関する情報(エラーが発生した場合)

- 再送信済インスタンス: インスタンスID、ユーザー・コメント、ユーザー名、タイムスタンプなどの、転送再送信に関する情報(再送信が行われた場合)

- ターゲット配信: 転送に関連付けられているターゲットに関する情報。ターゲット名をクリックすると、ターゲットのレポートに移動できます。

- 拡張: あまりアクセスされない情報(内部IDなど)

- セキュリティ: セキュリティに関連する情報(該当する場合)。アルゴリズム、証明書、暗号化などです。

転送レポートに表示される情報の詳しい説明は、Oracle Fusion Middleware MFT Composerヘルプ・オンライン・ヘルプの転送レポートに関する項を参照してください。

5.5.4 ターゲット・レポート

ターゲット・レポートには次のセクションがあります。

- フロー表示とコントロール: フロー・ダイアグラム、「リフレッシュ」ボタン、レポートのタイトル、「一時停止」ボタン、「再開」ボタンおよびターゲットの再送信ボタン

- サマリー: ファイル名、ターゲットの場所、合計時間、再送信回数などの基本的情報

- エラー: エラー・コード、レベル、カテゴリ、インスタンスID、タイムスタンプ、説明などの、エラーに関する情報(エラーが発生した場合)

- 再送信済インスタンス: インスタンスID、ユーザー・コメント、ユーザー名、タイムスタンプなどの、ターゲット再送信に関する情報(再送信が行われた場合)

- ターゲット前処理: 前処理アクション(圧縮、圧縮解除、暗号化など)に関する情報

- ターゲット後処理: 後処理アクション(圧縮解除など)に関する情報

- 拡張: あまりアクセスされない情報(転送とターゲットのラベルや内部ターゲットIDなど)

- セキュリティ: セキュリティに関連する情報(該当する場合)。アルゴリズム、証明書、暗号化などです。

ターゲット・レポートに表示される情報の詳しい説明は、Oracle Fusion Middleware MFT Composerヘルプ・オンライン・ヘルプのターゲット・レポートに関する項を参照してください。

5.6 転送の一時停止と再開

進行中の転送の一時停止を、ターゲット・レポートから行うことができます。ターゲット・レポートにアクセスするには、次の方法があります。

- 「ファイル・ファインダ」ビューで、「検索対象」を「ターゲット」に変更し、ファイルまたはターゲット名で検索してから、ターゲットの名前をクリックするとレポートが開きます。

- 「アクティブな配信」ビューで、転送の名前をクリックして転送レポートを開いてから、フロー・ダイアグラムの中のターゲット・アイコンをクリックするとターゲット・レポートが開きます。

注意:

1つの転送に複数のターゲットがある場合は、転送の一時停止をターゲットごとに個別に行う必要があります。

ターゲット・レポートで、「一時停止」をクリックするとターゲットへのファイル配信が一時停止します。ファイル配信を再開するには、「再開」をクリックします。

5.7 転送の再送信

正常終了した転送を再送信してファイルを再配信できます。再送信はソース、転送またはターゲットのレポートから行います。ソース再送信、転送再送信またはターゲット再送信のボタンをクリックします。

転送のステータスが「失敗」の場合は、再送信すると転送を再試行できます。再送信をソース、転送、ターゲットのどのレポートから実行するかは、エラーが発生した場所によって決まります。エラーの詳細は、「転送エラーの診断」を参照してください。

再送信はただちに行われ、親アーティファクトでスケジュールが定義されていても無視されます。たとえば、再送信をターゲットから行う場合は、ターゲットでスケジュールが定義されていても無視されます。ただし、再送信をソースから行う場合は、ターゲットで定義されているスケジュールが遵守されます。

注意:
ページを手動でリフレッシュして、再送信ステータスの詳細を表示する必要があります。

再送信ボタンが使用不可能になる理由は様々ですが、主なものを次に示します。

- 転送されるファイルがすでに削除されている。

- 転送がまだ進行中である。

- 転送のスケジュールが設定されており、配信日時がまだ到来していない。

- ターゲット・アーティファクトが無効化されている。

- 再送信アクションを実行する権限がない。

- この転送を再送信する権限がない。

5.8 ファイル配信失敗の診断

エラーがなくても、ファイルが期待したとおりにターゲットの場所に到着しないこともあります。このことが起きた場合は、次の設定を確認してください。

- コンテンツ・フィルタによってファイルが配信対象から除外されている可能性があります。「コンテンツ・フィルタの設定」を参照してください。

- 配信後にファイルが移動したり名前が変更されたりすることがあります。レポートの中で「変更済ファイル名」またはターゲット・ファイル名を探してください。「ソース・レポート」、「転送レポート」または「ターゲット・レポート」と「配信後のファイルの移動と名前変更」を参照してください。

- ファイル転送は指定された日時にしか行われないことがあります。レポートの中で、「ステータス」が「スケジュール済」のものを探してください。「ソース・レポート」、「転送レポート」または「ターゲット・レポート」と「スケジュールの設定」を参照してください。

5.9 転送エラーの診断

「監視」ページの「ダッシュボード」タブの「最新のエラー」ビューが開いていない状態のときは、このビューにエラー・コード、メッセージとエンドポイント、およびタイムスタンプが表示されます。

開いた状態の「最新のエラー」ビューは検索可能な表であり、エラーの他にも情報が表示されます。たとえば、詳細な説明、インスタンス・タイプ(ソース、転送またはターゲット)、レベル、重大度です。ワイルド・カードとして%を使用できます。

開いていない状態のビューでエラー・コードをクリックするか、開いた状態のビューでエラー・メッセージをクリックすると、エラーが発生したソース、転送またはターゲットのレポートが開きます。このレポートには、エラー情報のセクションが追加されています。このレポートでは、追加情報の表示や転送の再送信ができます。「転送の再送信」を参照してください。

5.9.1 診断エラー・メッセージおよび説明

「最新のエラー」ビュー、WLSコマンド・ラインまたは診断ログなど、MFTコンソールに表示できる特定のMFTエラー・メッセージに関する詳細は、Oracle Fusion MiddlewareエラーメッセージのMFTエラーメッセージの章を参照してください。

6 Oracle Managed File Transferの管理

この章では、Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーを管理する方法を説明します。

この章の内容は次のとおりです。

- サーバーのプロパティの変更

- MFT構成のインポートとエクスポート

- 大量ファイル転送のパフォーマンス向上のためのメモリー増加

- Oracle WebLogic Serverの起動と停止

- ファイアウォールを通してファイルを転送するためのMFT FTPプロキシ・サーバーの使用

- 複数のWeblogic Serverと高可用性の管理

- イベント通知の有効化

- Oracle Managed File Transferのエラー・プロセッサ・キューの構成

- Oracle Managed File Transferのログ出力

- Oracle Managed File Transferのログ・メッセージの表示

- 別の環境へのOracle Managed File Transferの移動

キーストアに関する情報は、「キーストアの管理」を参照してください。

ドメインに関する情報は、「ドメインの管理」を参照してください。

Oracle Managed File Transferの埋込みFTPおよびsFTPサーバーの管理の詳細は、「Oracle Managed File Transfer埋込みサーバーの管理」を参照してください。

6.1 サーバーのプロパティの変更

「管理」ページの「サーバー・プロパティ」タブは、次のセクションで構成されています。

- 一般構成プロパティ

- パフォーマンス・プロパティ

- 高可用性プロパティ

- 拡張配信プロパティ

これらのプロパティに対する変更を保存するには、「保存」をクリックします。前回保存以降の変更をすべて取り消すには、「元に戻す」をクリックします。

6.1.1 一般的なサーバー構成プロパティ

「サーバー・プロパティ」タブには、次の構成可能フィールドが表示されます。

- ペイロード・ストレージ・ディレクトリ: MFTペイロードが格納されるディレクトリの場所。これは、共有の場所である必要があります。
「ペイロード・ストレージ・ディレクトリ」のデフォルト値はWLS_Home/user_projects/domains/base_domain/mft/storageです。クラスタ内で複数のOracle WebLogic Serverインスタンスが稼働している場合は、共有の場所に設定する必要があります。

- コールアウト・ディレクトリ: カスタムのコールアウトJARファイルが格納されている共有ディレクトリの場所。MFTはコールアウトJARをこの場所からロードします。指定した場所に必要なJARが存在しないと、コールアウト処理は失敗します。デフォルトの場所はWLS_Home/user_projects/domains/base_domain/mft/calloutsです。

- インライン・ペイロードのストア: 「インライン・ペイロードのストア」設定では、インライン・ペイロードを転送後にファイル・システムとデータベースのどちらに格納するかを指定します。いずれかのオプションを選択する必要があります。

- 「ファイル・システム」を選択した場合は、「ペイロード・ストレージ・ディレクトリ」でファイル・システムの場所を指定します。構成したインライン・ペイロードのサイズが大きい場合、ファイル・システムをお薦めします。

- 「データベース」を選択した場合は、Oracle Managed File Transferの構成が格納されているデータベースにペイロードが格納されます。

- 参照ペイロードのストア: 「参照ペイロードのストア」チェック・ボックスでは、参照ペイロードをペイロード・ストレージ・ディレクトリに格納するかどうかを指定します。このチェック・ボックスを選択した場合は、「ペイロード・ストレージ・ディレクトリ」でファイル・システムの場所を指定します。チェック・ボックスを選択しなかった場合は、参照ペイロードは保持されません。
「ペイロード・ストレージ・ディレクトリ」を変更する手順は次のとおりです。

1. Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーを停止します。

2. 「ペイロード・ストレージ・ディレクトリ」の設定を変更します。

3. ディレクトリとファイルをペイロード・ストレージ・ディレクトリの下に移動します。

4. 管理対象サーバーを再起動します。
管理対象サーバーの停止と開始方法については、「ポートの再構成」を参照してください。

- チェックサムの生成: 「チェックサムの生成」設定は、1つのファイル内のすべてのビットが正常に転送されたことの確認に役立ちます。このチェック・ボックスが選択されている場合は、ターゲットに配信する前にOracle Managed File Transferによって各ペイロードに対するチェックサムが生成されて、データベースに格納されます。このチェックサムを比較すると、ファイルが転送中に破損していないことを確認できます。

注意:
チェックサムは、後の段階でペイロードを検証するのに必要です。これはオプションのフィールドで、チェックサムの生成にMFTが必要ない場合は、このフィールドを選択しないでください。これにより追加のチェックサムの計算が回避されるため、パフォーマンスが向上します。

6.1.2 パフォーマンス・プロパティ

各プロセッサの設定では、ファイル配信の各段階専用の処理スレッド数を指定します。3つの設定のデフォルト値はいずれも2です。

- ソース・プロセッサ: ソース・レベルで必要なメッセージ・プロセッサの数を決定します。これは転送識別とソース・レベルの処理関数実行を扱います。

- インスタンス・プロセッサ: 転送レベルで必要なメッセージ・プロセッサの数を決定します。これはターゲット・レベルの前処理関数実行を扱います。

- ターゲット・プロセッサ: ターゲット・レベルで必要なメッセージ・プロセッサの数を決定します。これは配信およびターゲット・レベルの後処理関数実行を扱います。
ターゲット・メッセージ処理または配信のようなロードの多くがこのレイヤーで発生するので、ほとんどの場合、この数はより大きくする必要があります。そのため通常これは他の2つのタイプのプロセッサよりも大きくすることができます。

転送の構成、定義済の処理関数および予期されるペイロード・パターンに基づいて、各プロセッサ設定に割り当てるスレッド数の増減が必要になる可能性があります。たとえば、ターゲット前処理に要する時間が配信に比べて短い場合は、最適なパフォーマンスとなるように「インスタンス・プロセッサ」の数を減らして「ターゲット・プロセッサ」の数を増やします。

Oracle Managed File Transferでは、スレッド同時実行性の問題を防止するために内部JCAアダプタの衝突検出機能が使用されます。

6.1.3 高可用性プロパティ

これらの設定は、高可用性のためのJCAアダプタのプロパティです。

- コントロール・ディレクトリはMFTファイル/FTPアダプタがHAユース・ケースを処理するのに必要なディレクトリ・パスです。MFTがHA環境で実行している場合、このフィールドは必須です。クラスタ内で複数のOracle WebLogic Serverインスタンスが稼働している場合は、共有の場所に設定する必要があります。たとえば、$DOMAIN_HOME/mft/control_diとします。

- 「インバウンド・データソース」は、高可用性に対応するスキーマが事前作成される場所である、MFTのインバウンドのデータ・ソースです。コントロール・ディレクトリが指定されない場合、このフィールドは必須です。デフォルト値(Oracle Managed File Transferの外部で決定されます)はjdbc/MFTDataSourceです。

- 「アウトバウンド・データソース」は、高可用性に対応するスキーマが事前作成される場所である、MFTのアウトバウンドのデータ・ソースです。コントロール・ディレクトリが指定されない場合、このフィールドは必須です。デフォルト値(Oracle Managed File Transferの外部で決定されます)はjdbc/MFTDataSourceです。

詳細は、テクノロジ・アダプタの理解の高可用性のためのOracleファイルおよびFTPアダプタの構成に関する項を参照してください。

6.1.4 拡張配信プロパティ

拡張配信の設定が必要になるのは、Oracle WebLogic Serverインスタンスがロード・バランサとともに実行されるときです。これらの設定では、ロード・バランサで使用される「内部アドレス」と「外部アドレス」(IPアドレス)および「FTP」、「FTPs」および「sFTP」のポートを設定します。この設定を使用するのは、Oracle Managed File TransferからペイロードがFTPまたはsFTP参照として送信されるときです。値が設定されている場合は、その値を使用してFTP参照(FTP/sFTPホスト・アドレスとポート)が構築されます。

内部アドレス: 配信の参照ケースに必要な内部プロキシ・アドレスおよびポート。

外部アドレス: 配信の参照ケースに必要な外部プロキシ・アドレスおよびポート。

Oracle MFTが内部および外部プロキシの背後で実行している場合、内部および外部IPアドレスは必須です。

詳細は、『Oracle WebLogic Serverクラスタの管理』のクラスタでのロード・バランシングに関する項を参照してください。

6.2 MFT構成のインポートとエクスポート

Oracle Managed File Transfer構成(つまりリポジトリ)のバックアップには、「管理」ページのすべての設定と、デザイナのすべてのアーティファクト(パスワード設定を除く)が含まれています。構成はZIPファイルに保存され、このファイルから後で復元できるようになっています。

このプロセスの手順は次のとおりです。

1. 「管理」ページの「インポート/エクスポート」タブを開きます。

2. 「エクスポート」をクリックします。
ファイルexport.zipに対してどのような処理を実行するかを尋ねる、オペレーティング・システムのダイアログ・ボックスが開きます。

3. 「ファイルを保存」を選択して、「OK」をクリックします。
オペレーティング・システムのファイル保存ダイアログ・ボックスが開きます。

4. ファイルを保存するディレクトリを選択します。

5. ファイル名を編集します。これはオプションです。

6. 「保存」をクリックします。

Oracle Managed File Transfer構成をバックアップから復元できます。これを行うと、既存の構成が上書きされます(パスワード設定を除く)。

転送アーティファクトを1つだけインポートまたはエクスポートするには、「転送のインポートとエクスポート」を参照してください。

WLSTのexportMftMetadataコマンドとimportMFTMetadataコマンドを使用してOracle Managed File Transfer構成のバックアップと復元を行うことができます。詳細は、『SOA Suite WLSTコマンド・リファレンス』のMFTメタデータ・コマンドに関する項を参照してください。

キーストアはOracle Managed File Transfer構成の一部ではありません。詳細は、「キーストアの管理」を参照してください。

6.3 大量ファイル転送のパフォーマンス向上のためのメモリー増加

大きなファイルの転送に時間がかかる場合や、メモリー不足例外が発生する場合は、メモリー(-Xms)またはヒープ・サイズを(-Xmx)を1GBまたは2GBまで増やします。たとえば、次のコマンドを実行するとメモリーが1GBに増え、ヒープ・サイズが2GBに増えます。

setenv USER_MEM_ARGS "-Xms1024m -Xmx2048m -XX:PermSize=256m -XX:MaxPermSize=768m"

6.4 Oracle WebLogic Serverの起動と停止

Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーの起動、再起動または停止を、Oracle Managed File Transferコンソールから行うことができます。

埋込みサーバーは、Oracle WebLogic Server管理対象サーバーとは別のものです。MFTの埋込みFTPサーバーおよびsFTPサーバーは、Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバー上で実行されるサービスです。MFTコンソールの埋込みサーバー・ポート管理のページに、この管理対象サーバーが一覧表示され、停止や起動ができます。

このプロセスの手順は次のとおりです。

1. 「管理」ページの左ペインで、「埋込みサーバー」の左にある矢印をクリックします。
「ポート」と「ユーザー・アクセス」という項目が表示されます。

2. 「ポート」をクリックします。
「埋込みサーバーのポート」タブが開きます。

3. 「サーバー・インスタンス」の表で、起動、再起動または停止するサーバー・インスタンスのチェック・ボックスを選択します。操作をすべてのサーバーに対して実行するには、「すべて選択」チェック・ボックスを選択します。

4. 「サーバー・ステータス」に注目します。サーバーを停止または再起動できるのは、RUNNINGの場合です。サーバーを起動できるのは、STOPPEDの場合です。

5. 「起動」、「停止」または「再起動」をクリックします。

6. 「リフレッシュ」アイコンをクリックして表を更新し、新しい「サーバー・ステータス」を確認します。

「ポート」タブの主な目的は、埋込みサーバーのポートを更新することです。詳細は、「ポートの再構成」を参照してください。

埋込みFTPおよびsFTPサーバーのみを起動および停止するには、「埋込みサーバーの起動と停止」を参照してください。

Oracle WebLogic Serverの起動、停止および障害回復を管理する方法の詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』のサーバーの起動および停止に関する項を参照してください。

6.5 ファイアウォールを通してファイルを転送するためのMFT FTPプロキシ・サーバーの使用

Oracle Managed File Transferには、MFT FTPプロキシ・サーバーが組み込まれており、このサーバーには次のような特性があります。

- サポートするプロトコルはFTP、sFTPおよびFTPSです。

- ファイアウォールの外側に独立して存在しているため、MFTをファイアウォールの外側にデプロイする必要がなくなります。

- 外部FTP要求を受け入れて、ファイアウォールの内側にあるMFTサーバーに転送します。

- 一般的には、単一のハードウェア・ロード・バランサに接続されます。

- 標準的なゲートウェイとリバース・プロキシのユース・ケースをサポートします。

- ポートとインバウンド・サーバーIPアドレスの構成が可能です。

- 標準的なFTPクライアントであればどれでもサポートします。

次に示すのは単純なトポロジの1つです。

FTPクライアント→MFT FTPプロキシ・サーバー→ハードウェア・ロード・バランサ→MFTサーバー・クラスタ

MFT FTPプロキシ・サーバーを構成するファイルの場所は、WLS_HOME/mft/applications/proxy/configです。Readme.txtファイルに、MFT FTPプロキシ・サーバーの構成とデプロイの方法が記載されています。

ファイアウォールの設定方法の詳細は、『Oracle WebLogic Serverクラスタの管理』のクラスタ・アーキテクチャのセキュリティ・オプションに関する項を参照してください。

プロキシ・サーバーがあるリモートSFTPサーバー

「トランスポート・プロバイダ」が「ソケット」に設定されている場合は、リモート・サーバーへの接続が直接になり、プロキシ定義は使用されません。「トランスポート・プロバイダ」が「HTTP」に設定されている場合は、リモートSFTPサーバーへの接続がプロキシ・サーバー経由になります。プロキシの詳細が入力されていないか無効な場合は、配信に失敗します。「トランスポート・プロバイダ」が「HTTP」に設定され、プロキシ設定が定義されて有効な場合、MFTではプロキシ・サーバー経由でファイルがターゲットに配信されます。

6.6 複数のWeblogic Serverと高可用性の管理

Oracle Managed File Transferは、Oracle WebLogic Serverの上で実行されます。したがって、Oracle Managed File Transferの高可用性の設定は、Oracle WebLogic Serverの高可用性の設定に依存します。

この項の内容は次のとおりです。

- 高可用性の構成

- クラスタ起動エラーの防止

- Oracle Managed File Transferでのロード・バランシング

6.6.1 高可用性の構成

このプロセスの手順の概要は次のとおりです。

1. JCAアダプタのプロパティのうち高可用性に関するものを、Oracle WebLogic Serverの構成時に設定します。これらは、高可用性プロパティを設定するのに必要です。詳細は、テクノロジ・アダプタの理解の高可用性のためのOracleファイルおよびFTPアダプタの構成に関する項を参照してください。

2. Oracle Managed File Transferをインストールするときのドメイン構成のステップで、管理対象サーバーのクラスタを作成します。詳細は、『Oracle Managed File Transferのインストールと構成』のOracle Managed File Transferのクラスタの構成に関する項を参照してください。

3. ソフトウェアまたはハードウェアのロード・バランサをインストールします。ロード・バランサで使用される「内部アドレス」と「外部アドレス」(IPアドレス)および「FTP」、「FTPs」および「sFTP」のポートを書き留めます。これらは、拡張配信プロパティを設定するのに必要です。詳細は、ロード・バランサのドキュメントを参照してください。

4. Oracle Managed File Transferの高可用性プロパティと拡張配信プロパティを構成して保存します。

5. 各管理対象サーバーを再起動します。「Oracle WebLogic Serverの起動と停止」を参照してください。

クラスタのトポロジ、仮想IPアドレス、ロード・バランシングのオプション、フェイルオーバーなどのトピックの詳細は、『Oracle WebLogic Serverクラスタの管理』のWebLogic Serverのクラスタリングの理解に関する項、仮想サーバーのIPおよびプールに関する項およびクラスタでのロード・バランシングに関する項を参照してください。

6.6.2 クラスタ起動エラーの防止

Oracle WebLogic Serverクラスタでユニキャスト・メッセージングを使用する場合に、クラスタ内のサーバーがすぐに同期しないときは、クラスタが再起動するときに次のようなメッセージが表示される可能性があります。

<Error> <oracle.soa.adapter.jms.inbound> <BEA-000000>
<JMSMessageConsumer_init:[destination =
MFTJMSServer_auto_2@jms/mft/MFTSourceQueue
(payload = 1)]:ERRJMS_ERR_CR_QUEUE_CONS.
Unable to create Queue receiver due to JMSException.

次のようなメッセージがスタック・トレースの中で見つかる可能性があります。

weblogic.jms.common.JMSException: could not find Server mft_server1

javax.naming.NameNotFoundException: Unable to resolve
'weblogic.messaging.dispatcher.S:mft_server1'. Resolved
'weblogic.messaging.dispatcher'; remaining name 'S:mft_server1'

通常はこれらのメッセージを無視してかまいません。サーバー同期は再試行され、通常は成功するからです。このメッセージが発生しないようにするには、次のいずれかを行います。

- MBean属性「メンバーのウォームアップ・タイムアウト」を30に設定します。このようにして同期を遅延させると、先にクラスタ内のサーバーを起動するための時間を確保できます。

- マルチキャスト・メッセージングを使用します。これを使用するときは、「メンバーのウォームアップ・タイムアウト」のデフォルト値が30に設定されます。

詳細は、『Oracle WebLogic Serverクラスタの管理』のクラスタ内の通信に関する項を参照してください。

6.6.3 Oracle Managed File Transferでのロード・バランシング

Oracle Managed File Transferには、クラスタ内の複数のOracle Managed File Transfer専用Oracle WebLogic Server管理対象サーバーで同じファイル転送インスタンスが実行されないことを保証するメカニズムがあります。転送のロード・バランシングはスティッキーです。

転送の進行中に管理対象サーバーが失敗すると、管理対象サーバーの再開時に転送が自動的に再送信されます。

6.7 イベント通知の有効化

Oracle Managed File Transferのイベント、たとえばエラーや新しいアーティファクトのデプロイメントのことを、特定のユーザーに通知できます。Oracle MFTは、通知にUMSを使用します。

イベントについて特定のユーザーに通知するには、Oracle Managed File TransferのためのWLSTのコマンドを使用して通知を構成し、次に電子メールまたはSMSのドライバを構成します。通知イベント・タイプには、次のものがあります。

- RUNTIME_ERROR_EVENT: メッセージ処理、サーバー起動、ソース・エラー、システム・イベント障害エラーなど、イベントの中で発生したエラー。

- DELETE_ARTIFACT_EVENT: 転送、ソースまたはターゲットの削除。

- DEPLOY_ARTIFACT_EVENT: 転送、ソースまたはターゲットのデプロイメント。

- EXPORT_IMPORT_EVENT: MFT構成のインポートまたはエクスポート。

- PURGE_EVENT: 実行時転送インスタンスまたは転送ペイロードのパージ。

- ARCHIVE_RESTORE_EVENT: 実行時転送インスタンスまたは転送ペイロードのアーカイブまたは復元。

JMS MFTExceptionQueueが有効かどうか、または、通知対象の連絡先が存在するかどうかに関係なく、通知メッセージはすべてそこに送信されます。MFT例外キューの詳細は、MFTExceptionQueueを参照してください。

イベント通知を有効にする手順は次のとおりです。

デフォルトでは、イベント通知はすべて無効化されています。次のWLSTコマンドを使用して、MFT通知を有効にします。WLSTコマンドの詳細は、WLSTコマンドの実行を参照してください。

1. 次のWLSTコマンドを使用して開始します。

- 次のコマンドを使用してWLSTコンソールを起動します: $MW_HOME/mft/common/bin/wlst.sh

- MBeanサーバーに接続します: connect("adminusername","adminpassword","t3://localhost:mft–port")。ポートはMFTサーバーの構成済ポートです。

- 接続されたら、次のコマンドを実行します。

2. 通知先となるユーザー、つまり連絡先を作成します。例: createContact('Email', 'jane.doe@example.com')

3. 連絡先を通知イベントに関連付けます。例: addContactToNotification('DEPLOY_ARTIFACT_EVENT', 'Email', 'jane.doe@example.com')

4. 通知イベントを有効化します。例: updateEvent('RUNTIME_ERROR_EVENT', true)
実行時処理エラーに対する通知が有効になります。指定したEメール・アドレスに実行時エラー・メッセージがEメールで通知されます。

種類がEMAILまたはSMSの通知が送られるようにするには、電子メールまたはSMSのドライバを構成する必要があります。詳細は、「通知のための電子メール・ドライバの構成」または「通知のためのSMSドライバの構成」を参照してください。

Oracle Managed File TransferのためのWLSTの通知コマンドの詳細は、『SOA Suite WLSTコマンド・リファレンス』のMFTイベント通知コマンドに関する項を参照してください。

6.7.1 通知のための電子メール・ドライバの構成

Oracle Enterprise Manager Fusion Middleware Controlを使用して、イベント通知のための電子メール・ドライバを構成します。

注意:
デフォルトでは、すべてのユーザー・メッセージング・サービス(UMS)チャネルがOracle固有の設定(メール・サーバー)で有効になります。外部顧客はEnterprise Managerでこれらの設定を変更して、通知が動作するようにする必要があります。

このプロセスの手順は次のとおりです。

1. Fusion Middleware Controlコンソールにログインします。

2. 「ターゲット・ナビゲーション」ペインで、「ユーザー・メッセージング・サービス」ノードを開きます。

3. 「usermessagingdriver-email」ノードを開きます。

4. Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーのノードを選択します。たとえば、このノードの名前はusermessagingdriver-email (mft_server1)などとなります。

5. 「usermessagingdriver-email」ページで、「ユーザー・メッセージング電子メール・ドライバ」→「電子メール・ドライバ・プロパティ」を選択して「電子メール・ドライバ・プロパティ」ページを開きます。

6. 「電子メール・ドライバ・プロパティ」ページで、実際に使用するメール・サーバーの、次に示す送信(必須)および受信(省略可能)のメール・サーバー・プロパティの値を入力します。

- 送信メール・サーバー

- 送信メール・サーバー・ポート

- 受信メール・サーバー

- 受信メール・サーバー・ポート

- 受信メールID

- 受信ユーザーID

- 受信パスワード

7. 「適用」をクリックします。

8. ログアウトしてもう一度Fusion Middleware Controlコンソールにログインし、これらのプロパティが正しく保存されていることを確認します。

9. 必要に応じて、Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーを再起動します。「Oracle WebLogic Serverの起動と停止」を参照してください。

通知に使用するデフォルトの送信者アドレスを変更するためのdefaultFromEmailAddressForNotification Mbeanプロパティは、現在no.reply@oracle.comに設定されています。

Fusion Middleware Controlでの電子メール・ドライバの構成方法の詳細は、Oracle User Messaging Serviceの管理の電子メール・ドライバの構成に関する項を参照してください。

6.7.2 通知のためのSMSドライバの構成

Oracle Enterprise Manager Fusion Middleware Controlを使用して、イベント通知のためのSMS (またはSMPP)ドライバを構成します。

注意:
デフォルトでは、すべてのユーザー・メッセージング・サービス(UMS)チャネルがOracle固有の設定(メール・サーバー)で有効になります。外部顧客はEnterprise Managerでこれらの設定を変更して、通知が動作するようにする必要があります。

このプロセスの手順は次のとおりです。

1. Fusion Middleware Controlコンソールにログインします。

2. 「ターゲット・ナビゲーション」ペインで、「ユーザー・メッセージング・サービス」ノードを開きます。

3. 「usermessagingdriver-smpp」ノードを開きます。

4. Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーのノードを選択します。たとえば、このノードの名前はusermessagingdriver-smpp (mft_server1)などとなります。

5. 「usermessagingdriver-smpp」ページで、「ユーザー・メッセージングSMPPドライバ」→「SMPPドライバ・プロパティ」を選択して「SMPPドライバ・プロパティ」ページを開きます。

6. 「SMPPドライバ・プロパティ」ページの「作成」をクリックします。

7. SMPPドライバ・プロパティの作成ページで、次のプロパティの値を入力します。

- SmsAccountId

- SmsServerHost

- TransmitterSystemId

- ReceiverSystemId

- TransmitterSystemType

- ReceiverSystemType

- DefaultSenderAddress

- ServerTransmitterPort

- TransmitterSystemPassword

8. 「OK」をクリックします。

9. ログアウトしてもう一度Fusion Middleware Controlコンソールにログインし、これらのプロパティが正しく保存されていることを確認します。

10. 必要に応じて、Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーを再起動します。「Oracle WebLogic Serverの起動と停止」を参照してください。

Fusion Middleware ControlでのSMSドライバの構成方法の詳細は、Oracle User Messaging Serviceの管理のSMPPドライバの構成に関する項を参照してください。

6.8 MFTExceptionQueue

MFTをインストールする場合、MFTインストーラはMFTExceptionQueueと呼ばれるJMSキューを作成します。このキューを使用して、構成されていない通知用のイベントをトレースします。イベントをトレースするために、サーバーは通知がイベントに対して有効かどうかをチェックします。通知が有効ではない場合、同じメッセージがMFTExceptionQueueに発行されます。

JMS MFTExceptionQueueを使用することで、次のイベントを追跡できます。

表6-1 イベント

イベント

説明

RUNTIME_ERROR_EVENT

このイベントは、実行時に発生したエラーを追跡します。次に例を示します。

- メッセージの処理中に発生したあらゆるエラー

- サーバー起動エラー

- システム・イベント障害エラー

EXPORT_IMPORT_EVENT

このイベントは、エクスポートおよびインポート・エラーの両方を追跡します。通知が構成されていない場合、MFTは例外キュー内のメッセージを送信します。

たとえば、サンプル・メッセージにはリポジトリのエクスポート全体が含まれます。このメッセージは、イベントが正常に行われたときにのみ送信されます。

DEPLOY_ARTIFACT_EVENT

このイベントは、アーティファクトのデプロイメント・イベントを追跡します。通知が構成されていない場合、MFTは例外キュー内のメッセージを送信します。

たとえば、サンプル・メッセージは、ソースのデプロイメント・イベントを示しています(「osbsrc1」など)。このメッセージは、デプロイメントが正常に行われたときにのみ送信されます。

DELETE_ARTIFACT_EVENT

このイベントは、ヒント・メタデータの削除を追跡します。

たとえば、ソース、転送およびターゲットの削除です。

PURGE_EVENT

このイベントは、実行時/ペイロード・パージを追跡します。実行時/ペイロード・パージが実行されるときに、MFTは例外キューのメッセージを送信します。このメッセージは、通知が構成されていない場合にかぎり、パージが正常に完了すると送信されます。

たとえば、サンプル・メッセージは実行時パージを示します。

ARCHIVE_RESTORE_EVENT

このイベントは、実行時/ペイロード・アーカイブおよびリストアを追跡します。実行時/ペイロード・データに対してアーカイブ/リストアが実行されるときに、MFTは例外キューのメッセージを送信します。このメッセージは、通知が構成されていない場合にかぎり、イベントが正常に完了すると送信されます。

たとえば、サンプル・メッセージは実行時アーカイブ・イベントを示します。

6.9 Oracle Managed File Transferのエラー・プロセッサ・キューの構成

MFTの実行時エラー・イベントを受け取るようにJMSキューを構成するには、Oracle WebLogic Server管理コンソールを使用します。

既存のMFT実行時プロセッサ・キューには次のものがあります。

- MFTSourceQueue

- MFTInstanceQueue

- MFTTargetQueue

この項では、これらの実行時プロセッサ・キューのそれぞれに対応するエラー・キューを作成する方法を説明します。

MFTでは、メッセージは非同期的に処理されます。1つのMFTメッセージが3つの異なるプロセッサにより処理され、各プロセッサに対し、次に示すように対応するキューがあります。

表6-2 プロセッサおよびキュー

プロセッサ

キュー

ソース・プロセッサ

MFTSourceQueue

インスタンス・プロセッサ

MFTInstanceQueue

ターゲット・プロセッサ

MFTTargetQueue

また、各MFTメッセージは、各プロセッサ用のJMSメッセージに対応します。エラー・プロセッサ・キューへの例外が発生する場合があります。

予期されるまたは予期されないシステム・レベルのエラーは、次の方法で処理されます。

- 予期されるシステム・レベルのエラー: ファイルが見つからないといった予期されるシステム・レベルのエラーに対し、"Error"とマークされた対応するMFTメッセージが存在します。
リモート・サーバーの停止といった配信関係の予期されるエラーに対し、対応するメッセージがターゲットの再試行設定に基づいて再試行されます。その他の予期されるエラーに対しては、再試行は行われません。

- 予期されないシステム・レベルのエラー: RAC障害またはJMS障害といった予期されないシステム・レベルのエラーがある場合、MFTはJMSメッセージを3回再試行します。再試行回数の上限に達したら、MFTメッセージはアクティブ・ステータスのままになります。対応するJMSメッセージはパージされるかどうかは、JMSプロセッサ・エラー・キューがMFT処理キューに関連付けられているかどうかによって異なります。
デフォルトでは、エラー処理キューは構成されません。この場合、JMSメッセージはパージされ、それ以外の場合は、JMSメッセージは構成されたエラー・キューにリダイレクトされます。

転送インスタンスがアクティブ・ステータスのまま長時間変化しない場合は、これらのエラー・キューを調べてください。エラー・キューの中のJMSメッセージには、転送インスタンスの詳細情報が記録されています。このメッセージIDをMFTログ・ファイルの中で検索すると、根本原因(エラー・スタック)を検索できます。問題が解決したら、再処理のためにJMSメッセージを対応する実行キューに再送信します。

エラー・キューを作成する手順は次のとおりです。

1. Oracle WebLogic Serverホスト名およびコンソール・ポートを含むURLを使用して、Oracle WebLogic Serverコンソールにアクセスします。

http://wls-hostname:console-port/console

次に例を示します。

http://localhost:7011/console

2. Oracle WebLogic Server管理者のユーザー名とパスワードを使用してログインします。

3. Oracle WebLogic Server管理コンソールの左ペインで、「サービス」ノードを開き、その下にある「メッセージング」ノードを開きます。

4. 「JMSモジュール」を選択します。

「JMSモジュールのサマリー」ページが表示されます。

5. JMSモジュールのリストから「MFTJMSModule」を選択します。

MFTJMSModuleの設定ページが表示されます。

MFTSourceQueue、MFTInstanceQueueおよびMFTTargetQueueが「リソースのサマリー」のリストにあることに注目してください。

6. 「新規」をクリックします。

「新しいJMSシステム・モジュール・リソースの作成」ページが表示されます。

7. 「キュー」を選択し、「次へ」をクリックします。

8. 新しいキューの「名前」と「JNDI名」を入力して「次へ」をクリックします。

たとえば、「名前」に「MFTSourceErrorQueue」と入力し、「JNDI名」に「jms/mft/MFTSourceErrorQueue」と入力します。

9. 「サブデプロイメント」ドロップダウン・リストで「MFTSubDeployment」を選択します。

10. 「ターゲット」のリストで「MFTJMSServer」を選択します。

11. 「終了」をクリックします。

MFTJMSModuleの設定ページが再表示され、新しいキューが「リソースのサマリー」リストに追加されています。

12. 「リソースのサマリー」リストで「MFTSourceQueue」を選択します。

MFTSourceQueueの設定ページが表示されます。

13. 「配信の失敗」タブを選択します。

14. 「有効期限ポリシー」ドロップダウン・リストから「リダイレクト」を選択します。

15. 新しいキューを「エラー宛先」ドロップダウン・リストで選択します。

16. 「保存」をクリックします。

17. ページの一番上にあるブレッドクラム・リストで「MFTJMSModule」を選択します。

MFTJMSModuleの設定ページが再表示されます。

18. 手順6から17までを再度実行して、JMSキュー「MFTInstanceQueue」と「MFTTargetQueue」のエラー・キューを構成します。

6.10 Oracle Managed File Transferのログ出力の構成

MFTコンポーネントのログ・メッセージは、この場所にあるログ・ファイルに書き込まれます。

WLS_HOME/user_projects/domains/base_domain/servers/mft_server1/mft_server1-mft-diagnostic.log

MFT埋込みサーバーのログ・メッセージは、この場所にあるログ・ファイルに書き込まれます。

WLS_HOME/user_projects/domains/base_domain/servers/mft_server1/mft-es/mft_server1-mft-es-diagnostic.log

Oracle Enterprise Manager Fusion Middleware Controlを使用して、これらのログ・ファイルのサイズを変更することや、メッセージをこれらのログ・ファイルに書き込む様々なログ出力のログ・レベルを設定できます。

このプロセスの手順は次のとおりです。

1. Fusion Middleware Controlコンソールにログインします。

2. ターゲット・ナビゲーション・ペインで、WebLogicドメイン・ノードを開きます。

3. Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーがインストールされているドメインのノードを開きます。
たとえば、ドメインはsoainfraまたはbase_domainです。

4. MFTサーバーを右クリックします。
たとえば、MFTサーバーはmft_server1です。

5. 「ログ」→「ログ構成」の順に選択します。

6. 「ログ・ファイル」タブを選択します。

7. 「odl-handler」を選択して「構成の編集」をクリックします。

8. 「最大ログ・ファイル・サイズ(MB)」と「すべてのログ・ファイルの最大サイズ(MB)」の値を編集して「OK」をクリックします。

9. 「ログ・レベル」タブを選択します。

10. 「ルート・ログ出力」ノードを開き、必要に応じてその他のノードも開いて、ログ・レベルの設定の対象となるログ出力を表示します。
表6-3は、MFTのコンポーネントに関係するログ出力の一覧です。表6-4は、MFTの埋込みサーバーに関係するログ出力の一覧です。

11. 各ログ出力について、「Oracle Diagnostic Loggingレベル(Javaレベル)」をSEVERE+100、SEVERE、WARNING、INFO、CONFIG、FINE、FINERまたはFINESTに設定します。デフォルトはINFOです。

12. 必要に応じて、「コンポーネントの再起動後もログ・レベル状態を維持」チェック・ボックスを選択します。

13. 「適用」をクリックします。

6.11 Oracle Managed File Transferのログ出力

表6-3 MFTコンポーネントのログ出力

ログ出力名

ログに記録されるイベント

デフォルト・レベル

本番のレベル

oracle.mft.ENGINE

メッセージ処理、処理関数とコールアウト、デプロイメント操作

INFO

SEVERE

oracle.mft.TRANSPORT

トランスポート層相互作用操作、システム・イベント

INFO

SEVERE

oracle.mft.COMMON

監査、通知、パージ、アーカイブ、復元、サーバー起動、共通ユーティリティAPI

INFO

SEVERE

oracle.mft.REPOSITORY

Java永続性操作

INFO

SEVERE

oracle.mft.METADATA

WLSTおよびEJBによって呼び出されたAPI処理

INFO

SEVERE

oracle.mft.SCHEDULER

スケジュール操作

INFO

SEVERE

oracle.mft.EMBEDDED_SERVER

埋込みサーバーとMFTサーバーとの通信

INFO

SEVERE

oracle.mft.SECURITY

セキュリティ操作、OWSMローカル・ポリシー

INFO

SEVERE

oracle.mft.CONSOLE_UI

コンソール操作

INFO

SEVERE

oracle.soa.adapter.file

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.file.inbound

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.file.outbound

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.file.connection

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.file.transaction

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.ftp

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.ftp.inbound

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.ftp.outbound

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.ftp.connection

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.jms

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.jms.inbound

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.jms.outbound

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.jms.connection

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

oracle.soa.adapter.jms.transaction

テクノロジ・アダプタの理解を参照してください。

INFO

SEVERE

表6-4 MFT埋込みサーバーのログ出力

ログ出力名

ログに記録されるイベント

デフォルト・レベル

本番のレベル

org.apache.ftpserver

FTP操作

INFO

SEVERE

org.apache.sshd

sFTP操作

INFO

SEVERE

6.12 Oracle Managed File Transferのログ・メッセージの表示

Oracle Enterprise Manager Fusion Middleware Controlを使用して、Oracle Managed File Transferのログ・ファイル内のメッセージを表示できます。

このプロセスの手順は次のとおりです。

1. Fusion Middleware Controlコンソールにログインします。

2. ターゲット・ナビゲーション・ペインで、WebLogicドメイン・ノードを開きます。

3. Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーがインストールされているドメインのノードを開きます。

たとえば、ドメインはsoainfraまたはbase_domainです。

4. MFTサーバーを右クリックします。

たとえば、MFTサーバーはmft_server1です。

5. 「ログ」→「ログ・メッセージの表示」の順に選択します。

「ログ・メッセージ」ページが表示されます。

6. MFTのログ・ファイルのリストを表示するには、「ターゲット・ログ・ファイル」をクリックします。

「ログ・ファイル」ページが表示されます。

7. ログ・ファイルを表示するには、ファイルを選択し、「ログ・ファイルの表示」をクリックします。

「ログ・ファイルの表示」ページが表示されます。

8. 特定のタイプのメッセージを表示するには、検索条件を指定し、「検索」をクリックします。

6.13 別の環境へのOracle Managed File Transferの移動

Oracle Managed File Transferをソース環境(たとえばテスト環境)からターゲット環境(たとえば本番環境)に移動できます。Oracle Fusion Middlewareには、Oracleホームおよびドメインに加えてOracle Managed File Transferの構成を、ある環境から別の環境にコピーするためのスクリプトが付属しています。手順の一環として、ソース環境から移動計画を抽出します。その後、移動計画に含まれているプロパティを編集して、ターゲット環境に適する値を設定できます。

詳細は、『Oracle Fusion Middlewareの管理』のテスト環境から本番環境への移行に関する項を参照してください。

7 Oracle Managed File Transfer埋込みサーバーの管理

この章では、Oracle Managed File Transferによって埋め込まれるFTPサーバーおよびsFTP (SSH-FTP)サーバーを管理する方法について説明します。

この章の内容は次のとおりです。

- 埋込みFTPおよびsFTPサーバーについて

- 埋込みサーバー構成

- 埋込みサーバーの起動と停止

- 埋込みサーバーと高可用性の管理

- サポートされるFTPおよびsFTPのコマンド

Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーの管理については、「Oracle Managed File Transferの管理」を参照してください。

7.1 埋込みFTPおよびsFTPサーバーについて

Oracle Managed File Transferには、FTPおよびsFTPのサーバーが組み込まれており、実行されるファイル転送のタイプの多くはこれらのサーバーで処理されます。埋込みサーバーの1つを使用してファイルを転送するには、ファイルを埋込みサーバーのディレクトリの1つにアップロードします。

これらの埋込みサーバーには専用のファイル・システム・ディレクトリがあり、これを使用してファイルを送受信します。FTPサーバーとsFTPサーバーの両方のデフォルトのルート・ディレクトリの場所は、WLS_Home/user_projects/domains/base_domain/mft/ftp_rootです。この場所を変更するには、「その他の埋込みサーバーの設定」を参照してください。

ルートの下のpayloadsディレクトリは、SOAなどの外部システムによってアクセスされるファイル用です。

FTP埋込みサーバーはデフォルトで有効になっていますが、そのセキュリティ機能は無効になっています。sFTPサーバーはデフォルトで無効になっています。

Oracle Managed File Transferでは、標準に準拠していればどのFTPまたはsFTPクライアントもサポートされます。

注意:

ソースのデプロイまたは有効化の前に埋込みFTPまたはsFTPソース・ディレクトリに存在していたファイルは無視されます。デプロイまたは有効化の後にディレクトリにアップロードされたファイルのみが検出され、転送されます。

7.1.1 セキュリティ

Oracle Managed File Transfer埋込みサーバーには、サーバー・ファイル・システムへのユーザー・アクセスを制限する機能があります。詳細は、「埋込みサーバーのセキュリティ」および「埋込みサーバーのユーザー・アクセス」を参照してください。

7.1.2 転送およびファイルのアーカイブおよびパージ

埋込みサーバー・ファイル・システムの空き領域を増やすには、WLSTのコマンドを使用して転送インスタンスおよび関連ファイルをアーカイブおよびパージします。詳細は、『SOA Suite WLSTコマンド・リファレンス』のMFTアーカイブおよびリストア・コマンドに関する項およびMFTパージ・コマンドに関する項を参照してください。

埋込みサーバー・ディレクトリにアップロードされたファイルのソースが構成されていない場合は、そのファイルのパージやアーカイブはできません。パージやアーカイブができるのは、転送インスタンスに関連付けられているファイルのみです。

7.2 埋込みサーバー構成

埋込みサーバー構成の設定は、「管理」ページの「埋込みサーバー」タブ、「埋込みサーバーのポート」タブおよび「埋込みサーバーのユーザー・アクセス」タブにあります。これらの設定の詳細は、次の各項を参照してください。

- 「埋込みサーバー」の設定については、「埋込みサーバーのセキュリティ」および「その他の埋込みサーバーの設定」を参照してください。

- 「埋込みサーバーのポート」の設定については、「ポートの再構成」を参照してください。

- 「埋込みサーバーのユーザー・アクセス」の設定については、「埋込みサーバーのユーザー・アクセス」を参照してください。

7.2.1 ポートの再構成

Oracle Managed File Transfer埋込みサーバーのポートを再構成できます。

埋込みサーバーは、Oracle WebLogic Server管理対象サーバーとは別のものです。MFTの埋込みFTPサーバーおよびsFTPサーバーは、Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバー上で実行されるサービスです。

このプロセスの手順は次のとおりです。

1. 「管理」ページの左ペインで、「埋込みサーバー」の左にある矢印をクリックします。

「ポート」と「ユーザー・アクセス」という項目が表示されます。

2. 「ポート」をクリックします。

「埋込みサーバーのポート」タブが開きます。

3. 「サーバー・インスタンス」と「サービス」(FTPまたはsFTP)の組合せのうち、再構成が必要なものの「構成済ポート」の値を変更します。

4. 「保存」をクリックします。

5. 「再起動」、「起動」または「停止」をクリックします。

6. 「リフレッシュ」アイコンをクリックして表を更新します。新しい「サーバー・ステータス」が、どのサーバーも「RUNNING」であることと、新しい「実行中のポート」の値に構成した値が反映されていることを確認します。

7.2.2 リモートのFTPおよびsFTPサーバーのパス・セパレータ

リモートFTPサーバーでのパス・セパレータが、慣例的なスラッシュ(/)ではない場合は、「FTPリモート」または「sFTPリモート」のソースやターゲットを構成するときに「FTPパス・セパレータ」を指定する必要があります。

「FTPリモート」または「sFTPリモート」のソースやターゲットを作成した後に編集できるその他の設定の詳細は、Oracle Fusion Middleware MFTコンポーザ・ヘルプ・オンライン・ヘルプを参照してください。

7.2.3 その他の埋込みサーバーの設定

表7-1は、FTP埋込みサーバーの設定のうち、セキュリティに関連しないものの一覧です。これらの設定は、「管理」ページの「埋込みサーバー」タブの「FTP」サブタブにあります。

表7-1 FTP埋込みサーバーの設定

設定

説明

ルート・ディレクトリ

FTPサーバーのルート・ディレクトリを指定します。デフォルトは、WLS_Home/user_projects/domains/base_domain/mft/ftp_rootです。クラスタ内で複数のOracle WebLogic Serverインスタンスが稼働している場合は、共有の場所に設定する必要があります。

ルート・ディレクトリを変更するには:

1. Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーを停止します。

2. 「ルート・ディレクトリ」設定を変更します。

3. ディレクトリおよびファイルをルート・ディレクトリの下に移動します。

4. 管理対象サーバーを再起動します。

管理対象サーバーの停止と開始方法については、「ポートの再構成」を参照してください。

有効

これを選択すると、sFTPサーバーが有効になります。デフォルトでは有効です(選択されています)。

最大ログイン

同時最大ユーザー数を指定します。デフォルトは10です。

ログイン失敗の最大回数

ログイン失敗の最大回数を指定します。これを超過すると接続が閉じます。デフォルトは3です。

最大同時リクエスト

このsFTPサーバーが受け入れることができる同時リクエストの最大数を指定します。デフォルトは10です。

アイドル・タイム・アウト

超過すると接続が終了し、ユーザーが再度ログインする必要がある時間を秒数で指定します。デフォルトは600で、これは10分に相当します。

アクティブな接続: 「ポート範囲開始」、「ポート範囲終了」

アクティブ・モードでは、クライアントがコマンド・チャネルを確立します。サーバーはPORTコマンドを使用して、「ポート範囲開始」から「ポート範囲終了」の範囲のサーバー・ポートとクライアントが指定するクライアント・ポートのデータ・チャネルを確立します。

有効化

これを選択すると、FTPサーバーが有効になります。MFTサーバーは、初期化時に無効なFTPサーバーを起動しません。デフォルトでは無効です(選択されていません)。

IPチェック

これを選択すると、データ接続のIPアドレスが制御ソケットと同じかどうかが確認されます。FTPではクライアントとサーバーの間で2つのチャネルが使用されます。これらは別個のTCP接続です。コマンド・チャネルはコマンドおよびレスポンス用です。データ・チャネルはファイル転送用です。デフォルトでは無効です(選択されていません)。

パッシブな接続: 「ポート範囲開始」、「ポート範囲終了」

パッシブ・モードでは、クライアントがコマンド・チャネルとデータ・チャネルの両方を確立します。「ポート範囲開始」と「ポート範囲終了」の範囲のどのポートをデータ・チャネルとして使用するかを、サーバーがクライアントに通知します。

表7-2は、sFTP埋込みサーバーの設定のうち、セキュリティに関連しないものの一覧です。これらの設定は、「管理」ページの「埋込みサーバー」タブの「sFTP」サブタブにあります。

表7-2 sFTP埋込みサーバーの設定

設定

説明

ルート・ディレクトリ

sFTPサーバーのルート・ディレクトリを指定します。デフォルトは、WLS_Home/user_projects/domains/base_domain/mft/ftp_rootです。クラスタ内で複数のOracle WebLogic Serverインスタンスが稼働している場合は、共有の場所に設定する必要があります。

ルート・ディレクトリを変更するには:

1. Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーを停止します。

2. 「ルート・ディレクトリ」設定を変更します。

3. ディレクトリおよびファイルをルート・ディレクトリの下に移動します。

4. 管理対象サーバーを再起動します。

管理対象サーバーの停止と開始方法については、「ポートの再構成」を参照してください。

有効

これを選択すると、sFTPサーバーが有効になります。デフォルトでは有効です(選択されています)。

最大同時リクエスト

このsFTPサーバーが受け入れることができる同時リクエストの最大数を指定します。デフォルトは10です。

ログイン失敗の最大回数

ログイン失敗の最大回数を指定します。これを超過すると接続が閉じます。デフォルトは3です。

アイドル・タイム・アウト

超過すると接続が終了し、ユーザーが再度ログインする必要がある時間を秒数で指定します。デフォルトは600で、これは10分に相当します。

埋込みサーバーの設定のうち、セキュリティに関連するものについては、「埋込みサーバーのセキュリティ」を参照してください。

7.3 埋込みサーバーの起動と停止

Oracle Managed File Transfer埋込みサーバーの起動と停止ができます。

このプロセスの手順は次のとおりです。

1. 「管理」ページの「埋込みサーバー」タブを開きます。

2. 「FTP」サブタブまたは「sFTP」サブタブを選択します。

3. 「起動」と「停止」のボタンに注目します。「起動」がグレー表示されている場合は、サーバーは実行中であり、そのサーバーの「停止」や「再起動」が可能です。「停止」がグレー表示されている場合は、サーバーは実行中ではなく、そのサーバーの「起動」が可能です。

4. 「インポート」、「停止」または「再起動」をクリックします。

すべての埋込みサーバーを再起動するには、「すべて再起動」をクリックします。

Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーを起動、再起動または停止するには、「Oracle WebLogic Serverの起動と停止」を参照してください。

7.4 埋込みサーバーと高可用性の管理

Oracle Managed File Transferの高可用性をセットアップすると、埋込みサーバーはロード・バランシングやフェイルオーバーなどの機能の一部となります。詳細は、「複数のWeblogic Serverと高可用性の管理」を参照してください。

7.5 サポートされるFTPおよびsFTPのコマンド

サポートされるFTPのコマンドは次のとおりです。

- APPE: データをリモート・ホスト上のファイルの末尾に追加します。

- AUTH: SSL暗号化セッションを確立します。SSLタイプのみがサポートされます。

- CDUP: 親ディレクトリに移動します。

- CWD: 作業ディレクトリを変更します。ディレクトリ名が指定されない場合は、ルート・ディレクトリ(/)であるとみなされます。

- LIST: ファイルのリストを返します。この前にPORTコマンドまたはPASVコマンドが必要です。

- MKD: ディレクトリを作成します。

- MLSD: LISTに似ています。

- NOOP: 操作は行われません。

- PASS: パスワードを指定します。直前にUSERがあることが必要です。

- PASV: データ・ポートでリスニングします。

- PORT: データ・ポートを指定します。

- PROT: データ・チャネル保護レベルを指定します。

- PWD: 現在の作業ディレクトリの名前を返します。

- REST: ファイル転送を再開する位置であるマーカー位置を指定します。

- RETR: 引数として指定されたファイルのコピーを転送します。

- SIZE: ファイルのサイズ(バイト単位)を返します。

- STOR: ファイルとして受信したデータを受け入れて保存します。

- TYPE: ファイル・タイプ、ascii (デフォルト)またはbinaryを指定します。

- USER: ユーザー名を指定します。

- QUIT: ログアウトします。

- DELE: パスで指定されたファイルを削除します。

- RMD: ディレクトリを削除します。

- RNFR: 指定された名前から変更します。

- RNTO: 指定された名前に変更します。

- STOU: 一意のファイルをこのディレクトリに保存します。

サポートされるsFTPのコマンドは次のとおりです。

- cd: リモートの作業ディレクトリを変更します。

- get: ファイルをリモート・ディレクトリからローカル・ディレクトリにダウンロードします。

- ls: リモート・ディレクトリの内容のリストを返します。

- mkdir: リモートのディレクトリを作成します。

- mv: リモートのファイルを移動するか名前を変更します。

- put: ファイルをローカル・ディレクトリからリモート・ディレクトリにアップロードします。

- pwd: リモートの作業ディレクトリの内容を出力します。

- rm: リモートのファイルを削除します。

- rmdir: リモートのディレクトリを削除します。

- quit、bye: クライアントまたはユーザーのセッションを終了して接続を切断します。

Oracle Managed File Transferでは、シェル・コマンド実行はサポートされません。

8 Oracle Managed File Transferのセキュリティ

この章では、Oracle Managed File Transferおよびその埋込みFTPおよびsFTPサーバーのセキュリティを維持する方法を説明します。

この章の内容は次のとおりです。

- ユーザーの認証および認可

- 埋込みサーバーのセキュリティ

- シングル・サインオンのためのOracle Access Manager 11gとの統合

- PGPを使用したメッセージ暗号化

- キーストアの管理

- セキュリティ監査ロギングの有効化

- OWSMセキュリティ・ポリシー・アタッチメント

- Oracle Managed File TransferのSSLのみドメインの構成

8.1 ユーザーの認証と認可

ユーザーを構成し、Oracle Managed File Transferに対するアクセス権を付与し、埋込みFTPおよびsFTPサーバーのディレクトリと転送ペイロードに対する権限を付与できます。

注意:
ユーザーがすでにログインしているときにユーザーの権限が変更された場合、その変更は次のログインでのみ有効になります。一度ユーザーが認証されると、ユーザーの権限は、ユーザーがログアウトして再度ログインするまで変更されません。これはすべてのコンソール、WLST、RESTfulや、デプロイ、有効化/無効化、インポート/エクスポートまたは読出し/書込みなどの埋込みサーバー操作に適用されます。

8.1.1 ユーザーの構成

Oracle Managed File Transferのユーザーを構成してグループに割り当てる操作は、Oracle WebLogic Server管理コンソールで行います。

注意:

Oracle Managed File Transferは、OracleSystemUserとしてOracle Enterprise Scheduler Serviceと通信します。このユーザーを削除しないでください。削除した場合は、転送構成の中で「スケジュールの追加」をクリックしたときにOracleSystemUserは存在しませんというメッセージが返されて、監視レポートの「スケジュール詳細」が空白になる可能性があります。転送スケジュールの詳細は、「スケジュールの設定」を参照してください。

このプロセスの手順は次のとおりです。

1. Oracle WebLogic Serverホスト名およびコンソール・ポートを含むURLを使用して、Oracle WebLogic Serverコンソールにアクセスします。

http://wls-hostname:console-port/console

次に例を示します。

http://localhost:7011/console

2. Oracle WebLogic Server管理者のユーザー名とパスワードを使用してログインします。

3. Oracle WebLogic Server管理コンソールの左ペインで、「セキュリティ・レルム」を選択します。

4. 「セキュリティ・レルムの概要」ページで、レルムの名前(myrealmなど)を選択します。

5. 「レルム名」ページの「設定」で、「ユーザーとグループ」→「ユーザー」を選択します。

6. 「新規」をクリックします。

7. 「新規ユーザーの作成」ページの「名前」フィールドに、ユーザーの一意の英数字名を入力します。

8. 「説明」フィールドに説明を入力します。説明は、ユーザーの完全な名前にします。これはオプションです。

9. 「プロバイダ」ドロップダウン・リストで、DefaultAuthenticatorを選択します。

10. 「パスワード」フィールドに、ユーザーのパスワードを入力します。

パスワードの最小の長さは8文字です。プロダクションでは、ユーザー名とパスワードの組合せとしてweblogic/welcome1は使用しないでください。

11. ユーザーのパスワードを「パスワードの確認」フィールドに再入力します。

12. 「OK」をクリックして、変更を保存します。

13. 「ユーザー」表で、新規ユーザーの名前をクリックします。

14. 「ユーザー名」ページの「設定」で、「グループ」を選択します。

15. 「使用可能」リスト・ボックスでグループを選択して「選択済み」リスト・ボックスに移動します。1人のユーザーが複数のグループのメンバーになることができます。

MFTコンソール・アクセスのグループは表8-1、MFT埋込みサーバー・アクセスのグループは表8-2を参照してください。

16. 「保存」をクリックします。

詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのユーザーの作成に関する項およびグループへのユーザーの追加に関する項を参照してください。

8.1.2 Oracle Managed File Transferコンソール・アクセス

ユーザーがOracle Managed File Transferコンソールにログインするときに使用する名前とパスワードは、「ユーザーの構成」で説明しているプロセスで割り当てられます。Oracle Managed File Transferのどのページが最初に表示されるかは、そのユーザーのグループによって決まります。

- Administratorsの場合は、最初に「管理」ページが表示されます。

- Deployersの場合は、最初に「デザイナ」ページが表示されます。

- Monitorsの場合は、最初に「監視」ページが表示されます。

DeployersグループとMonitorsグループの両方に割り当てられているユーザーの場合は、最初に「デザイナ」ページが表示されます。

表8-1は、MFTコンソールに対するユーザー・アクセスのロール、グループおよび許可されたアクションの一覧です。コンソール・アクセスはロールのみに基づいています。埋込みサーバー・アクセスのロールとグループによってコンソール・アクセスが決定するわけではありません。

表8-1 MFTコンソールのロール、グループおよび権限

ロール

ロールを持つグループ

許可されているコンソールでのアクション

MFTAdmin

Administrators、OracleSystemGroup

「インポート」、「エクスポート」、パージ、「設計」、「デプロイ」、「監視」、「再送信」、「一時停止」-「再開」、「再試行」、「無効化」、「有効化」、StartES、StopES (すべてのアクション)

MFTMonitor

モニター

「監視」、「再送信」、「一時停止」-「再開」、「再試行」、「無効化」、「有効化」、StartES、StopES

MFTDesigner

Deployers

「設計」、「デプロイ」

8.1.3 埋込みサーバーのユーザー・アクセス

ユーザーに埋込みFTPおよびsFTPサーバーのディレクトリへのアクセス権を付与できます。

WLSTを使用して埋込みサーバーのユーザー・アクセスを構成するには、『SOA Suite WLSTコマンド・リファレンス』のOracle Managed File Transferのユーティリティに関する項およびMFT埋込みサーバーのコマンドに関する項を参照してください。

このプロセスの手順は次のとおりです。

1. 「管理」ページの左ペインで、「埋込みサーバー」の左にある矢印をクリックします。
「ポート」と「ユーザー・アクセス」という項目が表示されます。

2. 「ユーザー・アクセス」をクリックします。
「埋込みサーバーのユーザー・アクセス」タブが開きます。

3. 「ユーザー」、「グループ」または「ロール」を選択してから、ユーザー、グループまたはロールの名前をテキスト・フィールドに入力します。少なくとも3文字入力する必要があります。一致した場合は、テキスト・フィールドの下に表示されます。追加する一致をクリックします。
ユーザー、グループおよびロールを構成するには、「ユーザーの構成」で説明しているプロセスを使用します。

注意:

「アクセシビリティ・プリファレンス」で「スクリーン・リーダー・モードの有効化」が選択されている場合は、ユーザー、グループまたはロールの名前全体を入力する必要があります。詳細は、「言語、タイムゾーンおよびアクセシビリティ・プリファレンスの設定」を参照してください。

4. 「フォルダの追加」(+)アイコンをクリックします。
ユーザーのデフォルトのフォルダが表に追加され、「ホーム・フォルダとして設定」が選択された状態になります。

5. その他のフォルダを追加するには、「検索」アイコンをクリックします。

a. 検索するディレクトリを「使用可能なフォルダ」テキスト・ボックスに入力します。

b. 「使用可能なフォルダ」テキスト・ボックスの右にある矢印をクリックします。
検索ディレクトリのサブディレクトリが表示されます。

c. ディレクトリの左にある矢印をクリックすると、その下のサブディレクトリが表示されます。

d. ディレクトリを選択するには、そのチェック・ボックスを選択します。

e. 「選択項目の追加」をクリックします。

6. 別のホーム・フォルダを割り当てるには、「ホーム・フォルダとして設定」を選択します。これはオプションです。
「ホーム・フォルダとして設定」が選択されている場合は、ユーザーが埋込みサーバーにログオンしたときにそのホーム・フォルダが作業フォルダとなります。ホーム・フォルダが存在しない場合は、ログイン時に作成されます。

7. 次に示す権限を行ごとに設定します。すべての行の権限を設定するには、列見出しのチェック・ボックスを選択するか選択を解除します。

- サブフォルダへのアクセス: 同じ権限設定をすべてのサブフォルダに適用します。

- 読取り: ファイルの内容の表示を許可します。

- 書込み: ファイルの内容の変更を許可します。

- 削除: ファイルの削除を許可します。

- リスト: ディレクトリの内容の表示を許可します。

8. 「保存」をクリックします。

特定のユーザーの、前回の保存以降のすべての権限変更を元に戻すには、「すべてリセット」をクリックします。すべてのユーザーの、前回保存以降の変更をすべて元に戻すには、「元に戻す」をクリックします。

表8-2は、MFT埋込みサーバーのディレクトリに対するユーザー・アクセスのグループと、デフォルトで許可されるアクションの一覧です。コンソール・アクセスのロールとグループによって埋込みサーバーへのアクセス権が決定するわけではありません。

表8-2 MFT埋込みサーバーのグループと権限

グループ

メンバー

許可されているアクション

その他の注意点

管理者

任意のエンタープライズ・ユーザー。

デフォルトでは、weblogicというユーザーがメンバーです。

「読取り」、「書込み」、「削除」、「リスト」(ファイルの操作)

createDir、renameDir、deleteDir、changeDir (ディレクトリの操作)

デフォルトでは、すべての権限がどのメンバーにも付与されます。

MFTESAdmin

任意のエンタープライズ・ユーザー。

デフォルトでは、Administratorsグループがメンバーです。

「読取り」、「書込み」、「削除」、「リスト」(ファイルの操作)

createDir、renameDir、deleteDir、changeDir (ディレクトリの操作)

このグループは、MFT埋込みサーバーに対するアクセス権を付与するためのものです。

デフォルトでは、すべての権限がどのメンバーにも付与されます。

OracleSystemGroup

任意のエンタープライズ・ユーザー。

デフォルトでは、OracleSystemUserというユーザーがメンバーです。

「読取り」、「書込み」、「削除」、「リスト」(ファイルの操作)

このグループをアクセス・プロビジョニングに使用することはお薦めしません。このグループは、内部アプリケーションおよびシステム管理のためのものであるからです。

その他の既存グループ

任意のエンタープライズ・ユーザー。

「読取り」、「書込み」、「削除」、「リスト」(ファイルの操作)

このグループの例としては、MonitorsやDeployersがあります。

これらのグループと、そのグループに属しているユーザーの一覧は、「埋込みサーバーのユーザー・アクセス」タブに表示されます。

ユーザーが作成したグループ

任意のエンタープライズ・ユーザー。

「読取り」、「書込み」、「削除」、「リスト」(ファイルの操作)

これらのグループと、そのグループに属しているユーザーの一覧は、「埋込みサーバーのユーザー・アクセス」タブに表示されます。

ユーザーが作成したロール

任意のエンタープライズ・ユーザーまたはグループ。

メンバー・グループに基づきます。ロールのメンバーとしてAdministratorsグループが含まれている場合は、すべての操作が許可されます。それ以外の場合は、ファイル操作のみが許可されます。

埋込みサーバーのアクセス・プロビジョニングのための既存ロールはありません。ロールを作成し、メンバーを割り当てて、アクセスをプロビジョニングできます。

8.1.4 ペイロード・アクセスの許可

ユーザー、グループおよびロールに、次のような特性を持つ転送のペイロードへのアクセス権を付与できます。

- ターゲット・タイプがSOAP、SOA、Service BusまたはODI

- 「配信方法」の値が「参照」

- 「参照タイプ」の値が「FTP」

特定のアクセス権を付与しない場合は、すべてのユーザー、グループおよびロールが転送ペイロードにアクセスできるようになります。

このプロセスの手順は次のとおりです。

1. 左側のペインのナビゲータで「転送」の左にある矢印をクリックします。

転送がリストされます。

2. 転送名をクリックするか、転送名を右クリックして「開く」メニュー・アイテムを選択します。

その転送のタブが開きます。

3. 「ペイロードへのアクセス」の左にある矢印をクリックします。

「ペイロードへのアクセス」セクションが開きます。

4. 「ユーザー、グループ、およびロールの追加」をクリックします。

ユーザーの追加ダイアログが開きます。

5. カテゴリ(「ユーザー」、「ロール」または「グループ」)を選択します。

6. ユーザー、ロールまたはグループの名前の一部分または全体を「検索」フィールドに入力します。

少なくとも3文字入力する必要があります。一致した場合は、「検索」フィールドの下に表示されます。

7. 一致する名前のうち、どれを追加するかを選択します。

選択した名前が検索フィールドに表示されます。

8. 「リストに追加」をクリックします。

名前が「選択されたユーザー、グループおよびロール」のリストに表示されます。

ユーザー、ロールまたはグループをリストから削除するには、その右にある赤色の「X」をクリックします。

9. 追加するユーザー、ロールまたはグループごとに、手順5から8までを繰り返します。

10. 「ユーザーの追加」をクリックします。

ユーザーの追加を取り消すには、「取消」をクリックします。

ユーザーの追加ダイアログが閉じます。

11. 追加する各ユーザー、ロールまたはグループが転送タブの「ペイロードへのアクセス」セクションに表示されていることを確認します。

ユーザー、ロールまたはグループをリストから削除するには、その右にある赤色の「X」をクリックします。

12. 「保存」をクリックし、必要に応じて転送をデプロイします。

転送の構成方法の詳細は、「転送の構成」を参照してください。

8.2 埋込みサーバーのセキュリティ

埋込みサーバーのセキュリティを維持する方法は、sFTP (SSH-FTP)とFTPS (FTP over SSL)の2つのタイプがあります。

埋込みサーバーでサポートされるプロトコルは、FTP RFC959、FTP RFC2228、sFTP、FTPS、SSH-2、TLS 1.1およびTLS 1.2です。SSH-1プロトコルおよびSSHD (セキュア・シェル)はサポートされません。

8.2.1 sFTP (SSH-FTP)

表8-3は、sFTP埋込みサーバーの設定のうち、セキュリティに関連するものの一覧です。これらの設定は、「管理」ページの「埋込みサーバー」タブの「sFTP」サブタブにあります。これらの設定を変更した後に、その設定を反映するためにsFTPサーバーを停止および起動する必要があります。

表8-3 sFTP埋込みサーバーのセキュリティ設定

設定

説明

認証タイプ

認証タイプとして、パスワード(デフォルト)、公開鍵または両方を指定します。

ホスト・キー・エイリアス

認証用のSSH秘密鍵の別名を指定します。SSHの鍵を作成するには、「SSHキーストアの構成」を参照してください。

8.2.2 FTPS (FTP Over SSL)

表8-4は、FTP埋込みサーバーの設定のうち、セキュリティに関連するものの一覧です。これらの設定は、「管理」ページの「埋込みサーバー」タブの「FTP」サブタブにあります。これらの設定を変更した後に、その設定を反映するためにFTPサーバーを停止および起動する必要があります。

表8-4 FTP埋込みサーバーのセキュリティ設定

設定

説明

プレーンFTP

暗黙的または明示的SSLサポートがない、プレーンFTPがFTPサーバーで有効になります。プレーンFTPに加えて、暗黙的または明示的SSLサポートのどちらかまたは両方を有効にできます。デフォルトでは有効です(選択されています)。

暗黙的

クライアントはTLS/SSL ClientHelloメッセージでFTPSサーバーに即座にチャレンジする必要があります。FTPS対応でないクライアントは暗黙的SSLが有効なサーバーには接続できません。デフォルトでは有効です(選択されています)。

明示的

FTPサーバーがセッションを暗号化するようにクライアントが明示的にリクエストでき、暗号化方法を相互に同意できます。これは明示的FTPSまたはFTPESと呼ばれています。明示的モードは従来の方法と互換性があるので、プレーンFTPクライアントも引き続きFTPサーバーに接続できます。FTPSセキュリティを起動する一般的なコマンドには、AUTH TLSやAUTH SSLなどがあります。デフォルトでは有効です(選択されています)。

クライアント認証

クライアント認証のレベルとして、必要、希望、なしのいずれかを指定します。「暗黙的」または「明示的」を選択した場合にのみ指定します。

- 必要 - FTPサーバーのSSLエンジンは、ハンドシェイク時にクライアント認証を必要としています。

- 希望 - FTPサーバーのSSLエンジンは、ハンドシェイク時にクライアント認証をリクエストとしています。

- なし - クライアント認証は実行されません(デフォルト)。

プロトコル

セキュリティ・プロトコルとして、TLS(デフォルト)またはSSLを指定します。「暗黙的」または「明示的」を選択した場合にのみ指定します。

暗号スイート

使用する暗号スイートを指定します。使用可能なすべての暗号スイートを使用するには、「すべて」を選択します。何も選択しないと、デフォルト・リストが使用されます。「暗黙的」または「明示的」を選択した場合にのみ指定します。

証明書エイリアス

認証用のSSL秘密鍵の別名を指定します。「暗黙的」または「明示的」を選択した場合にのみ指定します。SSLの鍵を作成するには、「SSLキーストアの構成」を参照してください。

注意:

次に示すメッセージは、問題点ではなく、使用できる有効なポートがない場合にFTPSサービスが開始されないことを示すために記録される情報です。このエラー情報は、暗黙的FTPSサービスが有効な場合は表示されません。

{APP: mft-app] [partition-name: DOMAIN]
oracle.mft.COMMON.<MFTServer.initFTPServer>:Invalid value for FTPS Port: [-1]. FTPS Service will fail to start.

8.3 シングル・サインオンのためのOracle Access Manager 11gとの統合

Oracle Managed File TransferコンソールのURLにOracle Access Manager 11gを統合すると、他のエンタープライズWebアプリケーションとのシングル・サインオンが実現します。

Oracle Access Managerのインストールと構成の全般的な情報は、Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイドのOracle Access Manager (OAM)の構成に関する項を参照してください。

MFTコンソールのURLを保護するには、Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイドのOAMのためのWebLogic Server管理者コンソールとEnterprise Managerの構成に関する項で説明している手順を実行します。ただし、リソースURLとして/mftconsole /mftconsole/* /mftconsole/.../*を指定します。

8.4 PGPを使用したメッセージ暗号化

転送されるファイルの暗号化や復号化を行うことができます。詳細は、「ソースでの暗号化と復号化」または「前処理での暗号化と復号化」を参照してください。

暗号化の場合は、PGP公開鍵の別名を参照する必要があります。復号化の場合は、PGP秘密鍵の別名を参照する必要があります。

Oracle Managed File Transferキーストア内でPGP鍵と鍵別名を設定するには、「PGPキーストアの構成」を参照してください。

8.5 キーストアの管理

Oracle Managed File Transferでは、SSLとSSHの鍵を使用して埋込みサーバーのセキュリティを維持し、PGP鍵を使用してメッセージを暗号化します。Oracle Managed File Transferキーストア内の鍵を管理するには、Oracle WebLogic Scripting Tool (WLST)とOracle Managed File Transferコンソールを使用します。次の各項の説明を参照してください。

- SSLキーストアの構成

- SSHキーストアの構成

- PGPキーストアの構成

MFT WLSTキーストア管理コマンドを使用して、SSL、SSHおよびPGPの鍵の生成、インポート、エクスポート、削除、リストおよび更新を行うことができます。詳細は、SOA Suite用WLSTコマンド・リファレンスを参照してください。

注意:

バイナリ(DER)形式のSSL鍵はサポートされていません。BASE64 (PEMまたはCER)形式の鍵を使用してください。opensslコマンドを使用して、鍵の形式を変換できます。

長さが1024ビットを超える鍵がサポートされます。ただし、鍵の長さが1024ビットを超える場合は、エクスポートの制約があります。このような制限のほとんどは、JAVA_HOME\jre7\lib\securityディレクトリでJREレベルで指定されています。

注意:

追加のキーストアを作成するには、WLSTコマンドまたはOracle Enterprise Manager Fusion Middleware Controlコンソールを使用します。Fusion Middleware Controlの詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のキーストア・サービスでのキーと証明書の管理に関する項、Oracle Fusion Middlewareの管理に関するドキュメントのキーストア、ウォレットおよび証明書の管理に関する項および『Oracle Platform Security Servicesによるアプリケーションの保護』の資格証明ストアの管理に関する項を参照してください。

8.5.1 SSLキーストアの構成

Oracle MFT SSLのキーおよび証明書の保存には、デフォルト・キーストアが使用されます。デフォルト・キーストアを構成するには、WLSTとOracle Managed File Transferコンソールを使用します。

このプロセスの手順は次のとおりです。

1. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを起動します。

2. Oracle Platform Security Servicesキーストア・サービスにアクセスします。

svc = getOpssService(name='KeyStoreService')

3. SSLキーストアの作成:

svc.createKeyStore(appStripe='<StripeName>', name='<StoreName>',   password='<StorePassword>', permission=false/true)

4. SSL鍵を作成します。

svc.generateKeyPair(appStripe='StripeName', name='StoreName', password='StorePassword', dn='cn=CompanyURL', keysize='1024',
alias='Alias', keypassword='KeyPassword')

次に例を示します。

svc.generateKeyPair(appStripe='mft', name='mftDefaultStore', password='P@s$W0rd', dn='cn=www.mycompany.org', keysize='1024',
alias='mftssl', keypassword='P@s$W0rd2')

ストライプ名はmftと指定し、ストア名はmftDefaultStoreと指定します。Oracle Managed File Transferでは、これらの名前がデフォルトで使用されます。ストアと鍵のパスワードは省略可能です。

FTPサーバーのセキュリティを維持するには、このステップで構成したSSL秘密鍵の別名を参照します。「FTPS (FTP Over SSL)」の「証明書エイリアス」の説明を参照してください。

5. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを終了します。

6. Oracle Managed File Transferコンソールの「管理」ページの左ペインで、「キーストア」をクリックします。

7. 前のステップで鍵とストアのパスワードを指定した場合は、このページでそのパスワードを入力する必要があります。

鍵のパスワードを「秘密鍵のパスワード」フィールドに入力し、ストアのパスワードを「キー・パスワード」フィールドに入力します。

8. 「保存」をクリックします。

8.5.2 SSHキーストアの構成

SSHキーストアを構成するには、WLSTとOracle Managed File Transferコンソールを使用します。

このプロセスの手順は次のとおりです。

1. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを起動します。

2. WLSTのgenerateKeysコマンドを使用して、パスワードで保護されたSSH秘密鍵を作成します。鍵のタイプはRSAで、鍵のサイズは1024ビットです。次に例を示します。

generateKeys('SSH', 'P@s$W0rd','/export/ssh/ssh-pvt-keys.ppk')

上級ユーザー向けの追加の鍵パラメータを設定する場合は、ssh-keygenコマンドをかわりに使用できます。次に例を示します。

ssh-keygen -t rsa -b 2048 -f /export/ssh/ssh-pvt-keys.ppk -N P@a$W0rd

ssh-keygenの詳細は、ssh-keygen(1)をLinuxのマニュアル・ページで参照してください。

どちらのコマンドも、パスワードは省略可能です。

3. WLSTのimportCSFKeyコマンドを使用して鍵の別名をインポートおよび作成します。次に例を示します。

importCSFKey('SSH', 'PRIVATE', 'mftssh', '/export/ssh/ssh-pvt-keys.ppk')

sFTPサーバーのセキュリティを維持するには、このステップで構成したSSH秘密鍵の別名を参照します。「sFTP (SSH-FTP)」の「ホスト・キー・エイリアス」の説明を参照してください。

4. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを終了します。

5. Oracle Managed File Transferコンソールの「管理」ページの左ペインで、「キーストア」をクリックします。

6. 手順2でパスワードを指定した場合は、そのパスワードを「SSH秘密鍵のパスワード」フィールドに入力します。

7. 「保存」をクリックします。

8.5.3 PGPキーストアの構成

PGPキーストアを構成するには、WLSTとOracle Managed File Transferコンソールを使用します。

注意:

制限されている鍵の長さまたはアルゴリズムを使用してMFTの外部でPGPツールによってペイロードが暗号化されている場合、MFTでの復号化は失敗します。このような制限のほとんどは、JAVA_HOME\jre7\lib\securityディレクトリでJREレベルで指定されています。

このプロセスの手順は次のとおりです。

1. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを起動します。

2. WLSTのgenerateKeysコマンドを使用して、パスワードで保護されたPGP鍵ペアを作成します。次に例を示します。

generateKeys('PGP', 'P@s$W0rd','/export/pgp', 'example<example@example.com>')

パスワードはオプションです。

3. WLSTのimportCSFKeyコマンドを使用して各鍵の別名をインポートおよび作成します。次に例を示します。

importCSFKey('PGP', 'PUBLIC', 'mftpgppub', '/export/pgp/pub.asc')
importCSFKey('PGP', 'PRIVATE', 'mftpgppri', '/export/pgp/secret.asc')

暗号化の場合は、PGP公開鍵の別名を参照する必要があります。復号化の場合は、PGP秘密鍵の別名を参照する必要があります。詳細は、「ソースでの暗号化と復号化」または「前処理での暗号化と復号化」を参照してください。

4. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを終了します。

5. Oracle Managed File Transferコンソールの「管理」ページの左ペインで、「キーストア」をクリックします。

6. 手順2でパスワードを指定した場合は、そのパスワードを「PGP秘密鍵のパスワード」フィールドに入力します。

7. 「保存」をクリックします。

8.6 セキュリティ監査ロギングの有効化

Oracle Managed File Transferの監査ロギングを有効にするには、Oracle Enterprise Manager Fusion Middleware ControlまたはOracle WebLogic Scripting Tool (WLST)を使用します。

監査データのレポートを生成するには、『Oracle Platform Security Servicesによるアプリケーションの保護』の監査分析と監査レポートの使用に関する項を参照してください。

8.6.1 監査ロギングを有効化するためのFusion Middleware Controlの使用

このプロセスの手順は次のとおりです。

1. Fusion Middleware Controlコンソールにログインします。

2. ターゲット・ナビゲーション・ペインで、WebLogicドメイン・ノードを開きます。

3. Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーがインストールされているドメインを選択します。

たとえば、ドメインはsoainfraまたはbase_domainです。

4. そのドメインを右クリックし、「セキュリティ」→「監査ポリシー」を選択します。

5. 「監査コンポーネント名」ドロップダウン・リストで「MFT」を選択します。

MFTコンポーネントが表示されていない場合は、Oracle WebLogic Server管理サーバーと管理対象サーバーを再起動してください。詳細は、「Oracle WebLogic Serverの起動と停止」を参照してください。

6. 「監査レベル」を「中」に設定します。

7. 「適用」をクリックします。

8. Oracle WebLogic Server管理サーバーおよび管理対象サーバーを再起動します。詳細は、「Oracle WebLogic Serverの起動と停止」を参照してください。

8.6.2 監査ロギングを有効化するためのWLSTの使用

このプロセスの手順は次のとおりです。

1. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを起動します。

2. MFTの監査ロギングを有効にするには、次のWLSTコマンドを使用します。

setAuditPolicy(componentType="MFT",filterPreset="None")

filterPresetには、NoneのかわりにCustomまたはMediumを指定できます。

3. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを終了します。

監査ポリシーに関するWLSTコマンドの詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のWLSTを使用した監査ポリシーの管理に関する項を参照してください。

8.7 OWSMセキュリティ・ポリシー・アタッチメント

Oracle Managed File Transferでは、Oracle Web Services Manager (OWSM)のポリシーを使用してWebサービスのソースとターゲットのセキュリティを維持できます。Webサービスのソースとターゲットのタイプとしては、SOAP、SOA、Service Bus、ODIなどがあります。

注意:

WS-Security準拠のポリシーはサポートされません。

1つのソースまたはターゲットにつき1つのポリシー・ファイルをアタッチできます。ポリシー・ファイルの内容は、アタッチされたポリシーとオーバーライドされた属性です。

ポリシーをグローバルにアタッチするには、Oracle Enterprise Manager Fusion Middleware ControlまたはOracle WebLogic Scripting Tool (WLST)を使用します。ポリシーをローカルにアタッチするには、MFTコンソールまたはWLSTを使用します。

Webサービスのセキュリティは、次の各部分に分けることができます。

- 設計時: このときにソースやターゲットのポリシーがアタッチされて登録されます。

- 実行時: このときにポリシーが適用されます。適用されるのは、保護されるソースやターゲットが呼び出されたときです。

- ライフ・サイクル: ポリシーの管理は、ソースやターゲットのライフ・サイクルに関して行われます。

この項の内容は次のとおりです。

- グローバル・ポリシー・アタッチメントのためのFusion Middleware Controlの使用

- グローバル・ポリシー・アタッチメントのためのWLSTの使用

- ローカル・ポリシー・アタッチメントのためのMFTコンソールの使用

- ローカル・ポリシー・アタッチメントのためのWLSTの使用

- 実行時のポリシー適用方法

- ポリシーおよびアーティファクトのライフ・サイクル管理

- ポリシー登録の検証

8.7.1 グローバル・ポリシー・アタッチメントのためのFusion Middleware Controlの使用

ポリシーをどのようにアタッチするかは、ポリシーがインバウンド(ソースが対象)かアウトバウンド(ターゲットが対象)かによって決まります。加えて、クライアント・ポリシーの中には資格証明を必要とするものがあります。

8.7.1.1 ポリシー資格証明の管理

クライアント・ポリシーの中には、ユーザー名トークン・ポリシーのように、資格証明を必要とするものがあります。このようなポリシーをOracle Enterprise Manager Fusion Middleware Controlを使用してアタッチするには、あらかじめマップとキーを作成する必要があります。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の資格証明ストアの管理に関する項を参照してください。

このプロセスの手順は次のとおりです。

1. Fusion Middleware Controlコンソールにログインします。

2. ターゲット・ナビゲーション・ペインで、WebLogicドメイン・ノードを開きます。

3. Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーがインストールされているドメインを選択します。

たとえば、ドメインはsoainfraまたはbase_domainです。

4. そのドメインを右クリックし、「セキュリティ」→「資格証明」を選択します。

「資格証明」の表が表示されます。

5. 「マップの作成」をクリックします。

6. 「マップの作成」ダイアログの「マップ名」フィールドにoracle.wsm.securityと入力します。「OK」をクリックします。

oracle.wsm.securityという資格証明が「資格証明」の表に表示されます。

7. oracle.wsm.securityという資格証明を選択して「キーの作成」をクリックします。

8. 「キーの作成」ダイアログの「キー」フィールドにbasic.credentialsと入力します。ユーザー情報を、「ユーザー名」、「パスワード」および「パスワードの確認」の各フィールドに入力します。「OK」をクリックします。

oracle.wsm.securityという資格証明の左に展開矢印が表示されます。この矢印をクリックすると、basic.credentialsというキーが表示されます。

8.7.1.2 ソースのポリシー・セットの作成

ソースのポリシー・セットを作成してポリシーをアタッチできます。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware ControlによるWebサービス・ポリシーの管理に関する項を参照してください。

このプロセスの手順は次のとおりです。

1. Fusion Middleware Controlコンソールにログインします。

2. ターゲット・ナビゲーション・ペインで、WebLogicドメイン・ノードを開きます。

3. Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーがインストールされているドメインを選択します。

たとえば、ドメインはsoainfraまたはbase_domainです。

4. そのドメインを右クリックし、「Webサービス」→「WSMポリシー・セット」を選択します。

「WSMポリシー・セット・サマリー」表が表示されます。

5. 「作成」をクリックします。

6. 「ポリシー・セットの作成」の「一般情報の入力」ページで、「名前」に入力し、「有効」チェック・ボックスを選択し、「リソース・タイプ」ドロップダウン・リストで「SOAP Webサービス」を選択します。「次へ」をクリックします。

7. 「ポリシー・セットの作成」の「リソース・スコープの入力」ページで、次に示す情報を入力します。

- ドメイン名: Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーがインストールされているドメインの名前を入力します。
たとえば、ドメインはsoainfraまたはbase_domainです。

- アプリケーション名: *またはmftappと入力します。

- アプリケーション・モジュール名または接続名: *またはmftappと入力します。

- RESTfulアプリケーション、サービスまたはWebサービス・エンドポイントの名前: これは、SOAコンポジット・エンドポイントまたはOracle Managed File Transferソースです。ソースの場合は、{http://xmlns.oracle.com/fmw/mft/soap}MFTService_source-nameと入力します。

- ポート名: MFTServicePortと入力するか、SOAコンポジットのポート名を入力します(例: submit_ptt)。

8. 「次へ」をクリックします。「ポリシー・セットの作成」の「制約の入力」ページで、「次」をもう一度クリックします。

9. 「ポリシー・セットの作成」の「ポリシー参照の追加」ページで、「使用可能なポリシー」リストでポリシーを1つ以上選択して「アタッチ」をクリックします。「次へ」をクリックします。

10. 「ポリシー・セットの作成」の「サマリー」ページで、「保存」をクリックします。

8.7.1.3 ターゲットのポリシー・セットの作成

ターゲットのポリシー・セットを作成してポリシーをアタッチできます。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware ControlによるWebサービス・ポリシーの管理に関する項を参照してください。

このプロセスの手順は次のとおりです。

1. Fusion Middleware Controlコンソールにログインします。

2. ターゲット・ナビゲーション・ペインで、WebLogicドメイン・ノードを開きます。

3. Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーがインストールされているドメインを選択します。

たとえば、ドメインはsoainfraまたはbase_domainです。

4. そのドメインを右クリックし、「Webサービス」→「WSMポリシー・セット」を選択します。

「WSMポリシー・セット・サマリー」表が表示されます。

5. 「作成」をクリックします。

6. 「ポリシー・セットの作成」の「一般情報の入力」ページで、「名前」に入力し、「有効」チェック・ボックスを選択し、「リソース・タイプ」ドロップダウン・リストで「SOAP Webサービス・クライアント」を選択します。「次へ」をクリックします。

7. 「ポリシー・セットの作成」の「リソース・スコープの入力」ページで、次に示す情報を入力します。

- ドメイン名: Oracle Managed File Transfer専用のOracle WebLogic Server管理対象サーバーがインストールされているドメインの名前を入力します。
たとえば、ドメインはsoainfraまたはbase_domainです。

- アプリケーション名: *と入力します。

- アプリケーション・モジュール名または接続名: *と入力します。

- RESTfulアプリケーション、サービスまたはWebサービス・エンドポイントの名前: SOAコンポジット・エンドポイント名を指定します。

- ポート名: ターゲットSOAコンポジットのポート名。

8. 「次へ」をクリックします。「ポリシー・セットの作成」の「制約の入力」ページで、「次」をもう一度クリックします。

9. 「ポリシー・セットの作成」の「ポリシー参照の追加」ページで、「使用可能なポリシー」リストでポリシーを1つ以上選択して「アタッチ」をクリックします。「次へ」をクリックします。

10. 「ポリシー・セットの作成」の「サマリー」ページで、「保存」をクリックします。

8.7.2 グローバル・ポリシー・アタッチメントのためのWLSTの使用

WLSTを使用して、1つのポリシーをOracle Managed File TransferのすべてのWebサービス・エンドポイントにアタッチできます。

このプロセスの手順は次のとおりです。

1. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを起動します。

2. 次のWLSTコマンドを使用してポリシー・セットを作成し、アタッチします。

beginRepositorySession())
createPolicySet('mft', 'ws-service', 'Domain("*")')
attachPolicySetPolicy('oracle/wss_username_token_service_policy')
validatePolicySet()
commitRepositorySession()
displayPolicySet('mft')

wss_username_token_service_policyは一例です。別のポリシーをアタッチできます。

3. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを終了します。

ソースとターゲットのどちらの場合も、ポリシーを特定のWebサービス・エンドポイントにアタッチすることもできます。

このプロセスの手順は次のとおりです。

1. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを起動します。

2. 次のWLSTコマンドを使用してポリシー・セットを作成し、アタッチします。

beginRepositorySession())
createPolicySet('mft', 'ws-service', 'Service("{http://xmlns.oracle.com/fmw/mft/soap}MFTService_SOAPSource")')
attachPolicySetPolicy('oracle/wss_username_token_service_policy')
validatePolicySet()
commitRepositorySession()
displayPolicySet('mft')

SOAPSourceは一例です。別のソースまたはターゲットのポリシー・セットを作成できます。

wss_username_token_service_policyは一例です。別のポリシーをアタッチできます。

3. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを終了します。

ポリシー・セットを管理するためのWLSTコマンドの詳細は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のポリシー・セット管理コマンドに関する項を参照してください。

8.7.3 ローカル・ポリシー・アタッチメントのためのMFTコンソールの使用

このプロセスの手順は次のとおりです。

1. MFTソースまたはターゲットに対応するSOAP、SOA、Service BusまたはODIのアプリケーションを作成してデプロイします。ターゲットの場合は、ポリシーをアプリケーションにアタッチする必要があります。

詳細は、「Oracle Managed File Transferと他の製品の統合」を参照してください。

2. ソースまたはターゲットを、「ソースの作成」または「ターゲットの作成」の説明に従って作成するか開きます。

3. 「保存」をクリックする前に、「ポリシー」の左にある矢印をクリックします。

「選択したポリシー」と「使用可能なポリシー」の表が表示されます。

4. 「使用可能なポリシー」を名前で検索するには、名前全体または一部分を「検索」フィールドに入力して「検索」アイコンをクリックします。

5. 「使用可能なポリシー」リストでポリシーを1つ以上選択します。

6. 「アタッチ」をクリックします。

選択したポリシーが「選択したポリシー」リストに移動します。

1つ以上のポリシーをデタッチするには、そのポリシーを選択して「デタッチ」をクリックします。

7. 「保存」をクリックします。

8. ソースまたはターゲットを転送に追加します(「転送の構成」の説明を参照)。

9. 転送をデプロイします(「転送のデプロイとテスト」の説明を参照)。

アタッチされたポリシーは自動的にOWSMに登録されます。登録を検証するには、「ポリシー登録の検証」を参照してください。

8.7.4 ローカル・ポリシー・アタッチメントのためのWLSTの使用

ソースとターゲットのどちらの場合も、ポリシーを特定のWebサービス・エンドポイントにアタッチできます。

ポリシーをアタッチする手順は次のとおりです。

1. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを起動します。

2. 次のWLSTコマンドを使用してポリシー・セットを作成し、アタッチします。

beginWSMSession()
listWSMPolicySubjects('mft-app')
selectWSMPolicySubject('/weblogic/soainfra/mft-app', '#SOAPSource',
'WSService({http://xmlns.oracle.com/fmw/mft/soap}MFTService_SOAPSource#MFTServicePort)')
attachWSMPolicy('oracle/binding_authorization_denyall_policy')
attachWSMPolicy('oracle/wss_username_token_service_policy')
previewWSMEffectivePolicySet()
commitWSMSession()

SOAPSourceは一例です。別のソースまたはターゲットのポリシー・セットを作成できます。

wss_username_token_service_policyは一例です。別のポリシーをアタッチできます。

3. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを終了します。

ポリシーをデタッチする手順は次のとおりです。

1. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを起動します。

2. 次のWLSTコマンドを使用してポリシー・セットを作成し、アタッチします。

beginWSMSession()
listWSMPolicySubjects('mft-app')
selectWSMPolicySubject('/weblogic/soainfra/mft-app', '#SOAPSource',
'WSService({http://xmlns.oracle.com/fmw/mft/soap}MFTService_SOAPSource#MFTServicePort)')
detachWSMPolicy('oracle/binding_authorization_denyall_policy')
detachWSMPolicy('oracle/wss_username_token_service_policy')
previewWSMEffectivePolicySet()
commitWSMSession()

SOAPSourceは一例です。別のソースまたはターゲットのポリシー・セットを作成できます。

wss_username_token_service_policyは一例です。別のポリシーをアタッチできます。

3. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを終了します。

ポリシー・セットを管理するためのWLSTコマンドの詳細は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のポリシー・セット管理コマンドに関する項を参照してください。

8.7.5 実行時のポリシー適用方法

ソースの場合は、送信ユーザーが、転送されるファイルとともにポリシーとその必須資格証明を指定する必要があります。このとおりでない場合は、ファイル転送に失敗します。

ターゲットの場合は、受信ユーザーがポリシーを指定する必要はありません。これは、転送の送信ユーザーの責任です。ただし、ターゲットにアタッチされるポリシーとその必須資格証明を送信ユーザーが指定しない場合は、ファイル転送に失敗します。

ポリシーに必要な資格証明に含まれるものとしては、ユーザー名、パスワード、証明書などのセキュリティ情報があります。詳細は、「ポリシー資格証明の管理」を参照してください。

8.7.6 ポリシーおよびアーティファクトのライフ・サイクル管理

ポリシー・ファイルはMFTメタデータ・ストア(MDS)の中で永続化され、ポリシー・ファイルが従うライフ・サイクルのパターンは、その親であるソースまたはターゲットのアーティファクトとまったく同じです。これには、バージョンも含まれます。

- アーティファクトを作成すると、ポリシー・ファイルがMDS内に作成されて、そのアーティファクトで参照されます。

- アーティファクトをデプロイすると、ポリシー・ファイルが自動的にOWSMに登録されます。

- アーティファクトをアンデプロイすると、ポリシー・ファイルの登録が解除されます。

- アーティファクトを有効化すると、ポリシー・ファイルが自動的にOWSMに登録されます。

- アーティファクトを無効化すると、ポリシー・ファイルの登録が解除されます。

- アーティファクトを削除すると、ポリシー・ファイルがMDSから削除されます。

- アーティファクトをエクスポートすると、ポリシー・ファイルがエクスポートされてアーティファクトのエクスポート・ファイルからリンクされます。

- アーティファクトをインポートすると、リンクされているポリシー・ファイルもインポートされます。

8.7.7 ポリシー登録の検証

ポリシーをグローバルまたはローカルにアタッチした後、WLSTを使用して、有効なポリシー・セットの一部としてそのポリシーがOWSMリポジトリに登録されていることを検証できます。

このプロセスの手順は次のとおりです。

1. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを起動します。

2. 次に示すWLSTコマンドを使用してMFTポリシー・サブジェクトを指定し、有効なポリシー・セットを表示します。

beginWSMSession()
listWSMPolicySubjects('mft-app')
selectWSMPolicySubject('/weblogic/soainfra/mft-app', '*', '*')
displayWSMEffectivePolicySet()
commitWSMSession()

displayWSMEffectivePolicySetコマンドの出力は、アタッチしたポリシーのリストです。

3. 「WLSTコマンドの実行」で説明されている手順を使用してWLSTを終了します。

ポリシー・サブジェクトに関するWLSTコマンドの詳細は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のポリシー・サブジェクト・コマンドに関する項を参照してください。

OWSMリポジトリの全般的な情報は、『Webサービスの管理』のWebサービスの管理の概要に関する項を参照してください。

8.8 Oracle Managed File TransferのSSL専用ドメインの構成

Oracle Managed File TransferにSSLのみドメインを作成します。

SSLのみドメインを構成する手順:

1. $DOMAIN_HOME/oracle_common/bin/ディレクトリに移動して、次のコマンドを実行します。
sh libovdconfig.sh -host <host> -port <port> -userName <wlsadminusername> -domainPath <AbsolutePathOfDomainHome> -createKeystore

2. Webブラウザからhttp://host:port/consoleに接続することで、AdminServerの証明書を抽出し、証明書をファイルにエクスポートします。証明書の詳細を入力します。
ファイル形式は"Base 64 Encoded x.509"である必要があります。

注意:
前の手順は統合されたeblogic LDAP (フォルト・オーセンティケータ)にのみ適用されます。その他のLDAPの場合、適切なLDAPコマンドを使用して、証明書をエクスポートする必要があります。

3. 次のコマンドを使用して、前の手順でエクスポートした証明書を作成したキーストアにインポートします。
keytool -importcert -keystore <DOMAIN_HOME>/config/fmwconfig/ovd/default/keystores/adapters.jks -storepass <password> -alias <alias> -file <filePath> -noprompt

パスワードはキーストアの生成中に指定され、ファイルパスはエクスポートされた証明書を含むファイルです。

4. 任意の別名を選択します。

5. SSL関連の変更を実行してSSLのみドメインを作成します。

6. WebLogic管理サーバーおよび管理対象サーバーを再起動します。
管理サーバーを再起動すると、MFTコンソールおよびSSLのみドメインの組込みサーバーにログインできます。

ドメインの作成後、SSLドメインを有効にする必要があります。SSLドメインを有効にするには、「SSLのみドメインの有効化」を参照してください。

8.8.1 SSL専用ドメインの有効化

SSLのみドメインの作成後、次の手順に従い、様々なユース・ケースでSSLを構成することで、ドメインを有効化します。

SSLのみドメインの有効化

次の手順に従って、SSLのみWebLogicドメインでOracle MFTを設定します。

1. 新しいドメインの場合は、ドメインの作成時にSSLリスニング・ポートを有効化します。

2. 既存のドメインの場合、ドメインを拡張してSSLリスニング・ポートを選択します。

3. AdminServerを開始し、管理対象サーバーおよびAdminServerの非SSLリスニング・ポートを無効化します。

4. 管理対象サーバーを起動します。

SSL経由Webserviceの起動(HTTPSサービス)

次の手順に従ってHTTP SSLプロトコル経由のSOA/SOAPターゲットを起動します。

1. リモートSSL WebサービスのSSL証明書をエクスポートします(Webブラウザからファイルへなど)。

2. 次のストアに証明書をインポートします。

a. jdk_home/jre/lib/security/cacerts

b. /wlserver/server/lib/cacerts

c. 「EM」>「セキュリティ」>「キーストア」>「システム」>「トラスト・ストア」、CAストア

3. サーバーを再起動します。

リモートSSL FTPサーバーの構成

次の手順に従い、リモートFTPソースまたはターゲットからリモートFTPサーバーに接続します。リモートFTPサーバーは非MFT FTPサーバーでもよく、MFTの別のデプロイメント内のMFT埋込みFTPサーバーでもかまいません。

1. 適切なツールを使用して、リモートSSL FTPサーバーに使用される信頼できる証明書をファイルにエクスポートします。MFT FTPSリモート・サーバーの場合、次のコマンドを使用してWLST経由で実行します。
svc.exportKeyStoreCertificate(appStripe='<stripe>',name='<store>',password='<storePassword>',alias='<certalias>',type='Certificate',filepath='<filePath>')

2. 次のWLSTコマンドを使用して、信頼できる証明書をMFTにインポートします。
svc.importKeyStoreCertificate(appStripe='<Stripe>',name='<Store>', password='<StorePassword>',alias='<certAlias>',keypassword='<keyPassword>',type='TrustedCertificate',filepath='<filepath>')

9 Oracle Managed File Transferのユーティリティ

この章では、Oracle Managed File Transfer (MFT)の操作を実行するWLST (Oracle WebLogic Scripting Tool)コマンドの要約を示します。

この章の内容は次のとおりです。

- WLSTコマンドの実行

- MFTのWLSTコマンドの要約

- Oracle MFT EJB

MFTのWLSTコマンドの詳しい説明と例については、SOA Suite用WLSTコマンド・リファレンスのOracle Managed File TransferのカスタムWLSTコマンドに関する項を参照してください。

9.1 WLSTコマンドの実行

WLSTのコマンドを実行するには、あらかじめWLSTを起動してMFT専用のOracle WebLogic Server管理対象サーバーに接続しておく必要があります。

このプロセスの手順は次のとおりです。

1. Oracle WebLogic ServerのMFTのコマンド・ディレクトリに移動します。

cd ${MW_HOME}/mft/common/bin

2. Oracle WebLogic Scripting Toolを実行します。

./wlst.sh

3. MFT専用のOracle WebLogic Server管理対象サーバーに接続します。

connect("username","password","t3://hostname:port")

次に例を示します。

connect("weblogic","weblogic1","t3://localhost:7011")

4. 必要なWLSTコマンドを実行します。

MFTのWLSTコマンドを一覧表示するには、このコマンドを使用します。

help("mft")

MFTのWLSTコマンドの短い名前を一覧表示するには、このコマンドを使用します。

help("mft-shortcuts")

コマンドの動作は、長い名前と短い名前のどちらを使用するかにかかわらず同じです。

5. 接続を切断して終了します。

disconnect()
exit()

9.2 MFTのWLSTコマンドの要約

表9-1は、MFTのWLSTコマンドの要約です。これはクイック・リファレンスであり、各コマンドの詳しい説明を目的とするものではありません。これらのコマンドの詳しい説明は、SOA Suite用WLSTコマンド・リファレンスのOracle Managed File TransferのカスタムWLSTコマンドに関する項を参照してください。

表9-1 MFTのWLSTコマンドの要約

コマンド

ショートカット

構文

説明

bulkDeployArtifact

buDepAF

bulkDeployArtifact('TRANSFER|SOURCE|TARGET',
'artifact_names', 'comment')

ソース、転送またはターゲットのアーティファクトのカンマ区切りリストをデプロイします。*はすべてを意味します。コメントは省略可能です。

createMftCredential

createMftCredential(password, key)

mftappの資格証明を作成します。資格証明を作成する必要があるパスワードと、資格証明のキーを入力します。

deleteArtifact

delAF

deleteArtifact('TRANSFER|SOURCE|TARGET',
'artifact_name')

ソース、転送またはターゲットのアーティファクトを削除します。

deleteArtifactDeployment

delDepAF

deleteArtifactDeployment('TRANSFER|SOURCE|TARGET',
'artifact_name', 'label')

アンデプロイされたソース、転送またはターゲットのアーティファクトを削除します。「デプロイメント」タブの「デプロイメントの詳細の表示」を使用すると、labelが表示されます。

deployArtifact

depAF

deployArtifact('TRANSFER|SOURCE|TARGET',
'artifact_name', 'comment')

ソース、転送またはターゲットのアーティファクトをデプロイします。コメントは省略可能です。

disableArtifact

disAF

disableArtifact('TRANSFER|SOURCE|TARGET',
'artifact_name', 'comment')

デプロイ済で以前に有効化されたソース、転送またはターゲットのアーティファクトを無効にします。コメントは省略可能です。

enableArtifact

enAF

enableArtifact('TRANSFER|SOURCE|TARGET',
'artifact_name', 'comment')

デプロイ済で以前に無効化されたソース、転送またはターゲットのアーティファクトを有効にします。コメントは省略可能です。

exportDeployedArtifact

expDepAF

exportDeployedArtifact('TRANSFER|SOURCE|TARGET',
'artifact_name', 'label', 'archive_file_path')

デプロイ済のソース、転送またはターゲットのアーティファクトをZIPファイルにエクスポートします。「デプロイメント」タブの「デプロイメントの詳細の表示」を使用すると、labelが表示されます。WLSTにリモート接続している場合は、ZIPファイルはリモート・サーバー上に作成されます。

isArtifactInMDS

isAFinMDS

isArtifactInMDS('TRANSFER|SOURCE|TARGET',
'artifact_name')

ソース、転送またはターゲットのアーティファクトがMDS (メタデータ・ストア)に存在するかどうかを調べてTRUEまたはFALSEを返します。

undeployArtifact

undepAF

undeployArtifact('TRANSFER|SOURCE|TARGET',
'artifact_name', 'comment')

ソース、転送またはターゲットのアーティファクトを、構成から削除せずにアンデプロイします。コメントは省略可能です。

exportMftMetadata

expMD

exportMftMetadata('archive_file_path')

MFT構成全体(パスワードを除く)をZIPファイルにエクスポートします。WLSTにリモート接続している場合は、ZIPファイルはリモート・サーバー上に作成されます。

exportTransferMetadata

expXfrMD

exportTransferMetadata('archive_file_path',
'transfer_name')

転送アーティファクトおよび関連するメタデータをZIPファイルにエクスポートします。WLSTにリモート接続している場合は、ZIPファイルはリモート・サーバー上に作成されます。

importMetadata

impMD

importMetadata('archive_file_path')

エクスポート済のMFT構成をZIPファイルからインポートします。

resetMetadata

resMD

resetMetadata('preserve_preferences')

MFT構成をリセットします。すべてのアーティファクトが削除され、すべての管理設定がデフォルト値にリセットされますが、省略可能なpreserve_preferencesがTRUEに設定されている場合はユーザー・プリファレンスをそのまま残します。

deleteCSFKey

delKey

deleteCSFKey('SSH|PGP', 'PRIVATE|PUBLIC', 'alias')

鍵別名をMFTキーストアから削除します。

exportCSFKey

expKey

exportCSFKey('SSH|PGP', 'PRIVATE|PUBLIC',
'key_file_path')

鍵をMFTキーストアからキー・ファイルにエクスポートします。

generateKeys

genKeys

generateKeys('SSH|PGP', 'password',
'key_file_path')

鍵を生成して1つ以上のキー・ファイルに保存します。鍵のタイプはRSAで、鍵のサイズは1024ビットです。秘密鍵のパスワードは省略可能です。

SSHの場合は、パスにキー・ファイル名が含まれている必要があります。

PGPの場合は、指定したパスの下に2つのファイルが生成されます。secret.ascファイルの内容はPGP秘密鍵で、pub.ascファイルの内容はPGP公開鍵です。

generateKeysによってサポートされない追加の鍵生成オプションには、ssh-keygenまたはgpgなどの外部鍵生成アプリケーションをお薦めします。

importCSFKey

impKey

importCSFKey('SSH|PGP', 'PRIVATE|PUBLIC', 'alias',
'key_file_path')

鍵をキー・ファイルからMFTキーストアにインポートして別名を作成します。

listCSFKeyAliases

lsKeyAliases

listCSFKeyAliases('SSH|PGP', 'PRIVATE|PUBLIC',
'alias')

MFTキーストア内の鍵別名のリストを返します。

updateCSFKey

updKey

updateCSFKey('SSH|PGP', 'PRIVATE|PUBLIC', 'alias',
'key_file_path')

鍵別名をMFTキーストアから削除して新しいキー・ファイルを作成します。

getSourceDeploymentHistory

getSrcDH

getSourceDeploymentHistory('source_name')

ソース・アーティファクトのデプロイメント履歴を返します。

getTargetDeploymentHistory

getTrgtDH

getTargetDeploymentHistory('target_name')

ターゲット・アーティファクトのデプロイメント履歴を返します。

getTransferDeploymentHistory

getXfrDH

getTransferDeploymentHistory('transfer_name')

転送アーティファクトのデプロイメント履歴を返します。

getTransferInfo

getXfrInfo

getTransferInfo('transfer_name', 'label')

転送アーティファクトに関する情報を返します。「デプロイメント」タブの「デプロイメントの詳細の表示」を使用すると、labelが表示されます。

pauseTransfer

pauseXfr

pauseTransfer('instance_id', 'comment')

進行中の転送を一時停止します。ターゲット・レポートの「拡張」セクションを開くと、インスタンスIDが表示されます。ターゲット・レポートの詳細は、「ソース、転送およびターゲットのレポートの解釈」を参照してください。コメントは省略可能です。

resubmit

resub

resubmit('resubmit_type', 'instance_ids',
'comment')

転送を再送信します。resubmit_typeのタイプは、SOURCE、TRANSFER_INSTANCE、TARGETまたはTARGET_INSTANCEです。ターゲット・レポートの「拡張」セクションを開くと、インスタンスIDが表示されます。ターゲット・レポートの詳細は、「ソース、転送およびターゲットのレポートの解釈」を参照してください。コメントは省略可能です。

resumeTransfer

resXfer

resumeTransfer('instance_id', 'comment')

一時停止している転送を再開します。ターゲット・レポートの「拡張」セクションを開くと、インスタンスIDが表示されます。ターゲット・レポートの詳細は、「ソース、転送およびターゲットのレポートの解釈」を参照してください。コメントは省略可能です。

configureHomeDir

confHmDir

configureHomeDir('directory_path', 'user_name')

指定されたディレクトリをホーム・ディレクトリとしてユーザーに割り当てます。そのユーザーが埋込みサーバーにログインしたときの作業ディレクトリとなります。

grantPermissionToDirectory

grPermDir

grantPermissionToDirectory('directory_path',
'principal_name', 'principal_type',
'permissions', 'server_type', 'include_subfolder')

埋込みサーバー・ディレクトリに対する権限を付与します。埋込みサーバー上の既存のディレクトリに対する権限のセットをユーザーやグループに割り当てることができます。

listAllPermissions

lsPerms

grantPermissionToDirectory('directory_path',
'server_type')

指定されたプリンシパルとサーバー・タイプに使用できるすべての権限のリストを返します。サーバー・タイプはFTPまたはsFTPです。

revokePermissionForDirectory

revPermDir

revokePermissionForDirectory('directory_path',
'principal_name', 'principal_type', 'permissions',
'server_type', 'include_subfolder')

埋込みサーバー・ディレクトリに対する権限のセットを取り消します。

startEmbeddedServer

startES

startEmbeddedServer('FTP|FTPS|SFTP')

停止している埋込みFTP、FTPS (FTP over SSL)またはsFTP (SSH-FTP)サーバーを起動します。

stopEmbeddedServer

stopES

stopEmbeddedServer('FTP|FTPS|SFTP')

実行中の埋込みFTP、FTPS (FTP over SSL)またはsFTP (SSH-FTP)サーバーを停止します。

updatePorts

updPorts

updatePorts('server_instance_name',
'FTP|FTPS|SFTP', 'port')

埋込みFTP、FTPS (FTP over SSL)またはsFTP (SSH-FTP)サーバーのポートを更新します。埋込みサーバーは、MFT専用のOracle WebLogic Server管理対象サーバーのサービスの1つです。

createCallouts

crtCalls

createCallouts('def_file_path')

コールアウトを定義するXMLファイルに基づいてコールアウトを作成します。

deleteCallout

delCalls

deleteCallout('callout_name')

コールアウトを削除します。

listCallouts

lsCalls

listCallouts()

コールアウトのリストを返します。

updateCallouts

updCalls

updateCallouts('def_file_path')

コールアウトを定義するXMLファイルに基づいて、同じ名前のコールアウトを更新します。

addContactToNotification

addContNote

addContactToNotification('event',
'Email|PHONE|FAX|SMS', 'value')

特定のイベント通知に連絡先を追加します。valueは、電子メール・アドレスまたは電話番号です。

eventは、RUNTIME_ERROR_EVENT、DELETE_ARTIFACT_EVENT、DEPLOY_ARTIFACT_EVENT、EXPORT_IMPORT_EVENT、PURGE_EVENTまたはARCHIVE_RESTORE_EVENTです。

createContact

crtCont

createContact('Email|PHONE|FAX|SMS', 'value')

イベント通知の連絡先を作成します。valueは、電子メール・アドレスまたは電話番号です。

deleteContact

delCont

deleteContact('Email|PHONE|FAX|SMS', 'value')

連絡先を削除します。valueは、電子メール・アドレスまたは電話番号です。

listContacts

lsConts

listContacts('Email|PHONE|FAX|SMS')

連絡先のリストを返します。

removeContactFromNotification

remContNote

removeContactFromNotification('event',
'Email|PHONE|FAX|SMS', 'value')

特定のイベント通知から連絡先を削除します。valueは、電子メール・アドレスまたは電話番号です。

eventは、RUNTIME_ERROR_EVENT、DELETE_ARTIFACT_EVENT、DEPLOY_ARTIFACT_EVENT、EXPORT_IMPORT_EVENT、PURGE_EVENTまたはARCHIVE_RESTORE_EVENTです。

updateEvent

updEvt

updateEvent('event', 'enabled')

特定のイベント通知を有効または無効にします。enabledをTRUEまたはFALSEに設定します。

eventは、RUNTIME_ERROR_EVENT、DELETE_ARTIFACT_EVENT、DEPLOY_ARTIFACT_EVENT、EXPORT_IMPORT_EVENT、PURGE_EVENTまたはARCHIVE_RESTORE_EVENTです。

archiveInstanceData

arcData

archiveInstanceData(archiveFileName='filename',
startDate='date', endDate='date',
batchId='batchId', status='C|F|A|*',
testMode='TRUE|FALSE', comments='text',
runInSync='FALSE|TRUE',
fsArchiveFolderPath='path')

ランタイム・インスタンスを.dmpファイルにアーカイブします。archiveFileNameは必須です。日付の形式はdd-MM-yyyy H:m:s:Sです。batchIdは、前のarchiveInstanceDataコマンドの出力の中にある識別子です。statusは、completed (デフォルト値)、failed、activeまたはallです。ランタイム・インスタンスをアーカイブするには、testMode=FALSEと設定します。runInSync=TRUEと設定すると、即座に実行が開始し、他のWLSTコマンドの実行はブロックされます。fsArchiveFolderPathは、対応するペイロードをアーカイブする場合は必須です。

restoreInstanceData

resData

restoreInstanceData(archiveFilePath='path',
fileNamePrefix='prefix', fsFolderPath='path',
runInSync='FALSE|TRUE')

アーカイブ済のランタイム・インスタンスを復元します。archiveFilePathは必須です。fileNamePrefix (通常はbatchId)およびfsFolderPathは、対応するペイロードを復元する場合は必須です。runInSync=TRUEと設定すると、即座に実行が開始し、他のWLSTコマンドの実行はブロックされます。

archivePayloads

arcPLs

archivePayloads(batchId='batchId',
archivePath='path', runInSync='FALSE|TRUE')

ランタイム・インスタンスに対応するペイロードをbatchId_n.zipファイルにアーカイブします。batchIdは、前のarchiveInstanceDataコマンドの出力の中にある識別子で、必須です。ペイロード・アーカイブ・ディレクトリへのarchivePathも必須です。runInSync=TRUEと設定すると、即座に実行が開始し、他のWLSTコマンドの実行はブロックされます。

restorePayloadsByName

resPLbyN

restorePayloadsByName(fileNames='filename',
folderPath='path',  runInSync='FALSE|TRUE')

ファイル名で指定されたアーカイブ済ペイロードを復元します。fileNames引数(通常はbatchId)は必須です。ペイロード・アーカイブ・ディレクトリへのfolderPathも必須です。runInSync=TRUEと設定すると、即座に実行が開始し、他のWLSTコマンドの実行はブロックされます。

restorePayloadsByPrefix

resPLbyP

restorePayloadsByPrefix(fileNamePrefix='prefix',
folderPath='path',  runInSync='FALSE|TRUE')

ファイル名接頭辞で指定されたアーカイブ済ペイロードを復元します。fileNamePrefix引数(通常はbatchId)は必須です。ペイロード・アーカイブ・ディレクトリへのfolderPathも必須です。runInSync=TRUEと設定すると、即座に実行が開始し、他のWLSTコマンドの実行はブロックされます。

purgeInstanceData

prgData

purgeInstanceData(startDate='date',
endDate='date', batchId='batchId',
status='C|F|A|*', testMode='TRUE|FALSE',
comments='text', runInSync='FALSE|TRUE',
runPayloadPurge='FALSE|TRUE')

ランタイム・インスタンスをパージします。引数はいずれも省略可能です。日付の形式はdd-MM-yyyy H:m:s:Sです。batchIdは、前のarchiveInstanceDataコマンドまたはpurgeInstanceDataコマンドの出力の中にある識別子です。statusは、completed (デフォルト値)、failed、activeまたはallです。ランタイム・インスタンスをアーカイブするには、testMode=FALSEと設定します。runInSync=TRUEと設定すると、即座に実行が開始し、他のWLSTコマンドの実行はブロックされます。runPayloadPurge=TRUEと設定すると、対応するペイロードがパージされます。

purgePayloads

prgPLs

purgePayloads(batchId='batchId',
detailedAudit='TRUE|FALSE',
runInSync='FALSE|TRUE')

ランタイム・インスタンスに対応するペイロードをパージします。batchIdは、前のarchiveInstanceDataコマンドまたはpurgeInstanceDataコマンドの出力の中にある識別子で、必須です。detailedAudit=FALSEと設定すると、パージされるファイルの監査がオフになります。runInSync=TRUEと設定すると、即座に実行が開始し、他のWLSTコマンドの実行はブロックされます。

注意:

MFT WLSTコマンド・ショートカットは、MFT WLSTコマンドの簡潔な別名です。これを使用したい場合には、フル・コマンドのかわりに使用することもできます。フル・コマンド名を使用する場合とショートカット・コマンド名を使用する場合とでは、コマンド動作に違いはありません。

9.3 Oracle Managed File Transfer EJB

WLSTコマンドもEJBとして公開されており、次のEJBのいずれかでコマンドを使用できます。

- oracle.tip.mft.j2ee.ejb.KeyManagerService

- oracle.tip.mft.j2ee.ejb.MDSService

- oracle.tip.mft.j2ee.ejb.RuntimeService

Oracleの法律上の注意点

コピーライト

Copyright © 1994-2017, Oracle and/or its affiliates. All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

Pre-General Availability (一般提供前)版のドキュメントについて

このドキュメントがPre-General Availability (一般提供前)版の場合:

このドキュメントはPre-General Availability (一般提供前)版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のPre-General Availability (一般提供前)版のドキュメントについて

このドキュメントが非公開のPre-General Availability (一般提供前)版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のPre-General Availability Trial Agreement (Pre-GAトライアル契約)のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle Partner Network Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティ

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info)か、聴覚に障害のあるお客様は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。