このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索の URL を出力します。
このスクリプトでは、e-docs マニュアルに必要なバナーを出力します。
このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索のパラメータを出力します。
HTTP 転送およびポーラー転送ユーザーズ ガイド
body コンテンツのストリーミング exactly-once に設定します。これにより、各メッセージが少なくとも 1 回は処理されることが保証されます。発信メッセージを処理する場合は、QoS を best-effort に設定します。
注意 : 転送されなかったメッセージに対処するには、パイプライン エラー ハンドラ内に (再試行ロジックを含めた) エラー処理ロジックを作成する必要があります。詳細については、『Oracle Service Bus Console の使い方』の「プロキシ サービス : エラー ハンドラ
Oracle Service Bus でのメッセージフローの作成
環境値
ダウンロード ディレクトリまたはリモートの場所から移動されるファイルの移動先ディレクトリです。
ファイル転送時にファイルがダウンロードされるローカル マシンのディレクトリです。
問題が発生した場合にメッセージがポストされる場所です。
(クラスタ シナリオで) ポーリングに使用する管理対象サーバです。
: Oracle Service Bus サービスは、常に、known_hosts ファイルに定義された公開鍵/ホスト/IP の組み合わせを使用して SFTP サーバを認証します。詳細については、「known_hosts ファイルの作成 」を参照してください。 : サーバ認証とクライアント認証の両方に成功した場合にのみ接続が確立されます。
注意 : ポーリング サイクルごとに新しい接続が作成されます。
.stage 拡張子の付いたファイル名に変更します。この名前変更により、サービスが次回のポーリング サイクルで同じファイルを選択しないことが保証されます。 .stage ファイルは、配信されるまで入力ディレクトリ内に存在します。
注意 : (ネットワーク障害などが原因で) 入力ディレクトリからファイルを取得できない場合、.stage ファイルはクリーンアップ サイクルで処理されます。クリーンアップ サイクルは、15 分ごとまたは 15 回のポーリング サイクルの後に実行されます (いずれか後に発生した方が実行されます)。連続する 2 回のクリーンアップ サイクルで.stage ファイルが存在する場合、ファイルは再度処理されます。
注意 : このタスクでは、メッセージを処理する際にプールされた接続を使用します。プールの接続を使用できない場合は、新しい接続が作成されます。
.stage ファイルが削除されます。
注意 : SFTP ビジネス サービスをコンフィグレーションしている場合、サービスはプールされた接続を使用して、メッセージを発信ディレクトリに配置します。
known_hosts ファイルに定義されたサーバの詳細に基づいて SFTP サーバを認証します。そのため、サーバ認証を有効にするには、クライアント マシンで known-hosts ファイルを作成する必要があります。
known_hosts ファイルは、Oracle Service Bus プロキシ サービス (着信要求) またはビジネス サービス (発信要求) が実行されているサーバに存在する必要があります。このファイルには、プロキシ サービスまたはビジネス サービスの接続先となるリモート SFTP サーバのホスト名、IP アドレス、および公開鍵が含まれている必要があります。
known_hosts ファイルを作成し、以下の形式で詳細情報を入力します。 Hostname, IP algorithm publickey
Hostname は、SFTP サーバのホスト名です。 IP は、SFTP サーバの IP アドレスです。 algorithm には、SFTP サーバのコンフィグレーションに基づいて、DSA または RSA のいずれかを指定できます。サポートされているアルゴリズムに応じて、ssh-rsa または ssh-dss と入力します。 publickey は、SFTP サーバの公開鍵です。公開鍵は、Open SSH 公開鍵形式であることが必要です。 例 :
getafix,172.22.52.130 ssh-rsa
known_hosts ファイルには、複数のエントリを含めることができますが、各エントリはそれぞれ別の行に入力する必要があります。
known_hosts ファイルを $DOMAIN_HOME\osb\transports\sftp ディレクトリに移動します。
注意 : /transports/sftp ディレクトリは、自動的に作成されるわけではありません。このディレクトリを作成する必要があります。
サービス アカウント known_hosts ファイルを作成します。詳細については、「known_hosts ファイルの作成 」を参照してください。
サービス キー プロバイダ known_hosts ファイルを作成します。詳細については、「known_hosts ファイルの作成 」を参照してください。
/etc/ssh/shosts.equiv ファイルを編集し、Oracle Service Bus ドメインを実行しているマシンのホスト名または IP アドレスを追加します。 /etc/ssh/ssh_known_hosts ファイルを編集して、Oracle Service Bus ドメインを実行しているマシンのホスト名または IP アドレスを追加し、その後にスペースを入力して公開鍵を追加します。
注意 : 公開鍵は、サービス キー プロバイダの作成時に使用したキー ストアから抽出できます。公開鍵は、Open SSH 形式であることが必要です。
サービス キー プロバイダ $HOME/.ssh/authorized_keys ファイルに入力する必要があります。このパスとファイルが存在することを確認してください。
known_hosts ファイルを作成します。詳細については、「known_hosts ファイルの作成 」を参照してください。 転送コンフィグレーション ] ページでプロキシ サービスを作成するときに、転送プロトコルとして sftp を選択し、次の形式でエンドポイント コンフィグレーションを指定する必要があります。
sftp://hostname:port/directory
hostname は、SFTP サーバのホスト名または IP アドレスです。 port は、SFTP サーバがリスンしているポートです。SFTP のデフォルト ポートは 22 です。 directory は、ファイルを定期的にポーリングする場所です。このディレクトリのパスは、ユーザのホーム ディレクトリからの相対位置になります。
注意 : SFTP 転送がサポートしているサービス タイプはメッセージと XML のみであるため、Oracle Service Bus Console の [全般的なコンフィグレーション ] ページで、サービス タイプとして [メッセージング サービス ] または [任意の XML サービス ] を選択する必要があります。
注意 : サービス タイプとして [メッセージング サービス ] を選択した場合、以下を実行する必要があります。
バイナリ ]、[テキスト ]、[MFL ]、または [XML ] を指定する必要があります。 なし ] に設定する必要があります。
プロキシ サービスは、指定されたユーザ認証方式に基づいて SFTP サーバによって認証されます。
ユーザ名/パスワード認証 : 静的サービス アカウントをこの認証方式に関連付け、サービス アカウントで提供される資格を使用してクライアントを認証します。 ホスト ベース認証 : ユーザ名とサービス キー プロバイダが必要です。既知のホストから接続するユーザは、ホストのプライベート キーを使用して認証されます。 公開鍵認証 : ユーザ名とサービス キー プロバイダが必要です。ユーザは、独自のプライベート キーを持ちます。
ユーザのサービス アカウントを入力するか、[
参照 ] をクリックしてサービス アカウントを選択します。サービス アカウントの使用方法については、『Oracle Service Bus Console の使い方』の「
サービス アカウント 」を参照してください。
このフィールドは、公開鍵認証方式とホスト ベース認証方式にのみ使用できます。
サービス キー プロバイダを入力するか、[
参照 ] をクリックしてサービス キー プロバイダを選択します。詳細については、『Oracle Service Bus Console の使い方』の「
サービス キー プロバイダ 」を参照してください。
この値は、ホスト ベース認証方式または公開鍵認証方式を選択した場合にのみ必要です。
このオプションを選択すると、ファイルはアーカイブ ディレクトリにステージングされ、参照としてヘッダに渡されます。
注意 : このオプションは、リモート ストリーミングが無効になっている場合にのみ使用できます。
このオプションを選択すると、処理時に SFTP のファイルがリモート サーバから直接ストリームされます。このオプションを選択した場合、SFTP サーバ マシンのリモート ディレクトリがアーカイブ ディレクトリになります。そのため、SFTP ユーザ ディレクトリからの相対パスでアーカイブ ディレクトリを指定する必要があります。
特定のタイプのファイルを転送する場合は、ファイル マスクを使用できます。
正規表現を入力して、ディレクトリから取り出すファイルを選択します。デフォルト値は
*.* です。
ポーリング間隔は、入力ディレクトリをポーリングする頻度です。ポーリングでは、SFTP 接続を作成する必要があります。
指定した場所からファイルをポーリングする間隔を秒単位で入力します。デフォルト値は
60 です。
注意 : 間隔が短いとディレクトリが頻繁にポーリングされるため、短いポーリング間隔を設定しないようにしてください。
ポーリング ディレクトリに多数のファイルが存在する場合は、このフィールドで適切な値を選択することにより同時転送の数を制限できます。
制限を指定しない場合は、
0 (ゼロ) を入力します。デフォルト値は
10 です。
注意 : SFTP サーバで同時接続数が制限されている場合があります。定義した読み込み制限がサーバで定義されている制限よりも少ないことを確認してください。
ファイル転送後にメッセージで実行する必要のあるアクションを選択します。
アーカイブ : メッセージは指定されたアーカイブ ディレクトリにアーカイブされます。 削除 : メッセージが削除されます。
[
読み込み後のアクション ] が [
アーカイブ ] に設定されている場合、ファイルは転送後に (ダウンロード ディレクトリまたはリモートの場所から) アーカイブ ディレクトリに移動します。
[
参照として渡す ] オプションを選択した場合は、アーカイブ ディレクトリを指定する必要があります。
リモート ストリーミングが有効になっている場合、アーカイブ ディレクトリは SFTP サーバのディレクトリになります。リモート ストリーミングが無効になっている場合は、Oracle Service Bus マシン上のアーカイブ ディレクトリを使用できます。
注意 : このディレクトリが存在しない場合は、自動的に作成されます。相対パスを指定すると、ディレクトリは WebLogic Server を起動する Java プロセスからの相対パスに作成されます。
ファイル転送時に、ファイルはこのディレクトリにダウンロードされます。
リモート ストリーミングが有効になっている場合、このオプションは無効になります。
ファイル転送時にファイルをダウンロードするローカル マシンのディレクトリの絶対パスを指定します。
注意 : このディレクトリが存在しない場合は、自動的に作成されます。相対パスを指定すると、ディレクトリは WebLogic Server を起動する Java プロセスからの相対パスに作成されます。
ファイル転送時に問題が発生した場合、メッセージはエラー ディレクトリにポストされます。
リモート ストリーミングが有効になっている場合、エラー ディレクトリは SFTP サーバのディレクトリになります。リモート ストリーミングが無効になっている場合は、Oracle Service Bus マシン上のエラー ディレクトリを使用できます。
注意 : このディレクトリが存在しない場合は、自動的に作成されます。相対パスを指定すると、ディレクトリは WebLogic Server を起動する Java プロセスからの相対パスに作成されます。
SFTP 転送での要求の文字セット エンコーディングとしてデフォルト値 (
UTF-8) を受け入れます。
エンドポイント URI で指定されたディレクトリ内のすべてのサブディレクトリを再帰的にスキャンする場合は、このオプションを選択します。
注意 : サブディレクトリをスキャンする場合、追加の処理オーバーヘッドが必要となります。そのため、このオプションは慎重に使用してください。
このオプションを選択すると、イベントは到着順に配信されます。これにより、メッセージ配信がランダムに行われるのではなく、ファイルが送り先ディレクトリにダウンロードされた時間に基づいて行われるようになります。
ソケット タイムアウト間隔を秒単位で入力します。この時間が経過すると、接続を切断する必要があります。接続をタイムアウトしない場合は、
0 を入力します。デフォルト値は
60 です。
この設定を使用すると、ネットワーク障害などのエラーの発生時に、複数回の試行が可能になります。
SFTP 接続に失敗した場合の再試行の回数を指定します。デフォルト値は
3 です。
プロキシ サービス : 作成と管理
この値は、送り先ディレクトリでファイル名として使用されます。
メタデータ フィールドです。指定可能な値は true と false です。
FileName がファイルの絶対パスとして解釈されます。 FileName がファイルの名前として解釈されます。
応答メタデータ フィールドです。
FileName ヘッダで指定したファイルが書き込まれる絶対パスを示します。
プロキシ サービス : アクション
FileName 転送ヘッダと isFilePath メタデータの値をコンフィグレーションできます。詳細については、『Oracle Service Bus Console の使い方』の「テスト コンソール テスト コンソールの使用
転送コンフィグレーション ] ページでビジネス サービスを作成するときに、転送プロトコルとして sftp を選択し、次の形式でエンドポイント URI (サービスの場所) を指定する必要があります。
sftp://hostname:port/directory
hostname は、SFTP サーバのホスト名または IP アドレスです。 port は、SFTP サーバがリスンしているポートです。SFTP のデフォルト ポートは 22 です。 directory は、発信メッセージが格納または書き込まれる場所です。このパスは、ユーザのホーム ディレクトリからの相対位置になります。
注意 : SFTP 転送がサポートしているサービス タイプはメッセージと XML のみであるため、Oracle Service Bus Console の [全般的なコンフィグレーション ] ページで、サービス タイプとして [メッセージング サービス ] または [任意の XML サービス ] を選択する必要があります。
注意 : サービス タイプとして [メッセージング サービス ] を選択した場合、以下を実行する必要があります。
バイナリ ]、[テキスト ]、[MFL ]、または [XML ] を指定する必要があります。 なし ] に設定する必要があります。
プロキシ サービスは、指定されたユーザ認証方式に基づいて SFTP サーバによって認証されます。
ユーザ名/パスワード認証 : 静的サービス アカウントをこの認証方式に関連付け、サービス アカウントで提供される資格を使用してクライアントを認証します。 ホスト ベース認証 : ユーザ名とサービス キー プロバイダが必要です。既知のホストから接続するユーザは、ホストのプライベート キーを使用して認証されます。 公開鍵認証 : ユーザ名とサービス キー プロバイダが必要です。ユーザは、独自のプライベート キーを持ちます。
ユーザのサービス アカウントを入力するか、[
参照 ] をクリックしてサービス アカウントを選択します。サービス アカウントの使用方法については、『Oracle Service Bus Console の使い方』の「
サービス アカウント 」を参照してください。
このフィールドは、公開鍵認証方式とホスト ベース認証方式にのみ使用できます。
サービス キー プロバイダを入力するか、[
参照 ] をクリックしてサービス キー プロバイダを選択します。詳細については、『Oracle Service Bus Console の使い方』の「
サービス キー プロバイダ 」を参照してください。
この値は、ホスト ベース認証方式または公開鍵認証方式を選択した場合にのみ必要です。
ソケット タイムアウト間隔を秒単位で入力します。この時間が経過すると、接続を切断する必要があります。接続をタイムアウトしない場合は、
0 を入力します。デフォルト値は
60 です。
リモート サーバに格納されるファイルの名前に使用するプレフィックスを入力します。
リモート サーバに格納されるファイルの名前に使用するサフィックスを入力します。
SFTP 転送での要求の文字セット エンコーディングとしてデフォルト値 (
UTF-8) を受け入れます。
ビジネス サービス : 作成と管理
モニタ
known_hosts ファイルを適切にコンフィグレーションしていることを確認します。 接続は拒否されました。」というエラー メッセージは、コンフィグレーション済みのホストとポートで SFTP サーバを使用できないことを示します。 認証が失敗しました」というエラー メッセージは、ユーザ名とパスワードが無効であること、または公開鍵が正しくコンフィグレーションされていないことを示します。 接続が正常に完了しませんでした。」というエラー メッセージは、接続エラーの原因となった実際のエラー (「キーが見つかりません」など) が表示された後に表示されます。 ホストのキーが見つかりません」というエラー メッセージは、指定された IP とホストの組み合わせに対応するエントリが known_hosts ファイルに含まれていないことを示します。エントリが存在する場合は、別のアルゴリズムのキーを使用して試行されます。たとえば、以前の試行で RSA キーが使用された場合は、DSA キーを使用して再試行されます。 セキュリティおよびポリシーのコンフィグレーションを保持 ] オプションを選択することで、そのリソースの既存のセキュリティおよびポリシーのコンフィグレーションの詳細を保持できます。リソースのインポート時に保持される SFTP サービス固有の詳細は次のとおりです。
リソースのインポート
表 2-5 に示します。
リモート サーバに格納されるファイルの名前に使用するプレフィックスです。
リモート サーバに格納されるファイルの名前に使用するサフィックスです。
ユーザ認証を使用する SFTP ビジネス サービスを UDDI レジストリから Oracle Service Bus にインポートすると、衝突が発生します。
round-robin です。
UDDI
