この章では、Oracle API Manager用のWebLogic Serverドメインを作成および構成する方法について説明します。
この章が終わるまでに、Oracle API Manager用のデータベース・スキーマが作成され、単一のホストに1つのクラスタと2つの管理対象サーバーを備えたOracle WebLogicドメインが構成されます。
内容は次のとおりです。
Oracle API Managerドメインを構成するには、このリリースのOracle API Managerでの使用が保証されているデータベースに必要なスキーマをインストールする必要があります。
これらのスキーマを、この項の手順に従ってインストールします。
動作保証されたデータベースを適切にインストールして構成し、そのデータベースを起動して稼働させておく必要があります。
詳細は、『Oracle Fusion Middlewareのインストールのプランニング』の「データベースおよびデータベース・スキーマのインストール」を参照してください。
この項の説明に従って、Oracle API Manager用のスキーマを作成します。
対象のデータベースに対するDBAアクティビティの実行に必要なパーミッションと権限が付与されている場合は、「システム・ロードおよび製品ロード」を選択します。この手順は、必要な権限が付与されていることを前提としています。
データベースに対するDBAアクティビティの実行に必要なパーミッションまたは権限が付与されていない場合は、この画面で、「システム・ロードに対するスクリプトの準備」を選択する必要があります。このオプションにより、SQLスクリプトが生成されます。このスクリプトをデータベース管理者に提出してください。リポジトリ作成ユーティリティを使用したスキーマの作成のシステム・ロードおよび製品ロードの理解に関する項を参照してください。
RCUがデータベースに接続できるようにするために、データベース接続の詳細を指定します。次の情報を指定する必要があります。
データベース・タイプ
ホスト名
ポート
サービス名
ユーザー名
パスワード
ロール
「次へ」をクリックして先に進み、データベースへの接続が成功したことを確認するダイアログ・ウィンドウで、「OK」をクリックします。
「接頭辞の新規作成」を選択して、「SOA Suite」スキーマを選択します。これにより、自動的に「SOAインフラストラクチャ」が選択され、同時に次のスキーマが依存関係として選択されます。
Metadata Services
監査サービス
監査サービスへの追加
監査サービス・ビューア
Oracle Platform Security Services
ユーザー・メッセージング・サービス
WebLogicサービス
共通インフラストラクチャ・サービスというスキーマも自動的に作成されます。このスキーマは、グレー表示されていて選択することも選択解除することもできません。このスキーマを使用すると、ドメインの構成中にRCUから情報を取得できるようになります。詳細は、リポジトリ作成ユーティリティを使用したスキーマの作成のサービス表スキーマの理解に関する項を参照してください。
カスタム接頭辞は、これらのスキーマを論理的にグループ化して、このドメイン内でのみ使用することを目的としています。複数のドメイン間でのスキーマの共有はサポートされていないため、ドメインごとに固有のスキーマのセットを作成する必要があります。
ヒント:
カスタム接頭辞の詳細は、リポジトリ作成ユーティリティを使用したスキーマの作成でカスタム接頭辞の理解に関する項を参照してください。
マルチドメイン環境のスキーマを構成する方法の詳細は、リポジトリ作成ユーティリティを使用したスキーマの作成のスキーマの作成計画に関する項を参照してください。
ヒント:
ここに入力するカスタム接頭辞は、メモしておく必要があります。このカスタム接頭辞は、後述するドメイン作成のプロセスで必要になります。
「次へ」をクリックして先に進み、スキーマ作成の前提条件チェックが成功したことを確認するダイアログ・ウィンドウの「OK」をクリックします。
スキーマのパスワードをデータベースに設定する方法を指定してから、パスワードの指定と確認を行います。
ヒント:
この画面で設定するパスワードは、メモしておく必要があります。このパスワードは、後述するドメイン作成のプロセスで必要になります。
この項では、構成ウィザードを使用してWebLogicドメインを作成するための指示について説明します。
ドメイン作成に使用可能なその他の方法の詳細は、『構成ウィザードによるWebLogicドメインの作成』のWebLogicドメインの作成、拡張および管理のための追加ツールに関する項を参照してください。
この項の内容は、次のとおりです。
ドメインの構成を開始するには、ORACLE_HOME
/oracle_common/common/bin
ディレクトリに移動して、WebLogic Server構成ウィザードを起動します。
UNIXオペレーティング・システムの場合:
./config.sh
Microsoft Windowsオペレーティング・システムの場合:
config.cmd
Windowsオペレーティング・システムでは、「スタート」メニューから「すべてのプログラム」を選択し、「Oracle」、「OracleHome」、「WebLogic Server 12c (12.1.3)」、「ツール」、「構成ウィザード」の順に選択することで構成ウィザードを起動することもできます。
この項の説明に従って、ドメインを作成して構成します。
注意:
API Managerドメインによる既存のService Busドメインの拡張はこのリリースではサポートされません。この項で説明されているように、API Managerドメイン構成テンプレートを使用して新しいドメインを作成する必要があります(Service Busもデプロイする)。
「構成タイプ」画面で、「新規ドメインの作成」を選択します。
「ドメインの場所」フィールドで、使用するドメイン・ホーム・ディレクトリを指定します。
Oracle Fusion Middlewareの理解のOracle Fusion Middlewareの主要ディレクトリに関する項にまとめられているディレクトリ構造(Oracleホーム・ディレクトリの外部にドメイン・ホームがある)に従って、ドメイン・ホームを配置することをお薦めします。このディレクトリ構造は、ソフトウェアのアップグレードや再インストールが必要になったときに問題を回避するために役立ちます。
ヒント:
ドメイン・ホーム・ディレクトリの詳細は、Oracle Fusion Middlewareのインストールのプランニングのドメイン・ホームの選択に関する項を参照してください。
この画面に示されるその他のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』の構成タイプに関する項を参照してください。
「テンプレート」画面では、「製品テンプレートを使用してドメインを作成」が選択されていることを確認し、次のテンプレートを選択します。
Oracle API Manager - 12.2.1. [osb]
このテンプレートを選択すると、次の依存関係も選択されます。
Basic WebLogic Server Domain - 12.2.1. [wlserver]
Oracle Service Bus - 12.2.1 [osb]
WebLogic Advanced Web Services for JAX-PRC Extension - 12.2.1 [wlserver]
ODSI XQuery 2004 Components - 12.2.1 - [oracle_common]
Oracle Enterprise Manager - 12.2.1 [em]
Oracle WSM Policy Manager - [oracle_common]
Oracle JRF - 12.2.1 [oracle_common]
WebLogic Coherenceクラスタの拡張 - 12.2.1 [wlserver]
ヒント:
この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のテンプレートに関する項を参照してください。
「アプリケーションの場所」画面では、ドメインに関連付けられたアプリケーションを格納する場所を選択します。この場所は、アプリケーション・ホーム・ディレクトリとも呼ばれます。
Oracle Fusion Middlewareの理解のOracle Fusion Middlewareの主要ディレクトリに関する項にまとめられているディレクトリ構造(Oracleホーム・ディレクトリの外部にアプリケーション・ホームがある)に従って、アプリケーション・ホームを配置することをお薦めします。このディレクトリ構造は、ソフトウェアのアップグレードや再インストールが必要になったときに問題を回避するために役立ちます。
ヒント:
アプリケーション・ホーム・ディレクトリの詳細は、Oracle Fusion Middlewareのインストールのプランニングのアプリケーション・ホームの選択に関する項を参照してください。
この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のアプリケーションの場所に関する項を参照してください。
「管理者アカウント」画面では、ドメインに対するデフォルトのWebLogic管理者アカウントにユーザー名とパスワードを指定します。
この画面で設定したユーザー名およびパスワードを書き留めておくことをお薦めします(これらの資格証明は、後でドメインの管理サーバーを起動して接続する際に必要になります)。
「ドメイン・モードおよびJDK」画面では、次の操作を実行します。
「ドメイン・モード」フィールドで、「本番」を選択します。
「JDK」フィールドで「Oracle Hotspot JDK」を選択します。
「本番モード」をこの画面で選択すると、環境で高度なセキュリティが実現され、アプリケーションのデプロイと管理サーバーの起動でユーザー名とパスワードが必要になります。
ヒント:
開発モードと本番モードの違いなど、この画面のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のドメイン・モードとJDKに関する項を参照してください。
本番モードでは、起動アイデンティティ・ファイルを作成することで、管理サーバーの起動時に必要なユーザー名とパスワードの指定を省略できます。詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の管理サーバー用の起動アイデンティティ・ファイルの作成に関する項を参照してください。
「RCUデータ」を選択して、この画面に示されるフィールドをアクティブ化します。「RCUデータ」オプションは、構成ウィザードにデータベースとサービス表(STB)スキーマに接続して、ドメインの構成に必要なスキーマに関するスキーマ情報を自動的に取得するように指示します。
注意:
この画面の「手動構成」を選択した場合は、「JDBCコンポーネント・スキーマ」画面でスキーマのパラメータを手動で入力する必要があります。
「RCUデータ」を選択してから、次の各フィールドに入力します。
フィールド | 説明 |
---|---|
DBMS/サービス |
データベースのDBMS名(サービス・タイプ・ドライバを選択している場合はサービス名)を入力します。 |
ホスト名 |
データベースをホストするサーバーの名前を入力します。 |
ポート |
データベースがリスニングするポート番号を入力します。 |
スキーマ所有者 スキーマ・パスワード |
データベースのサービス表スキーマに接続するためのユーザー名とパスワードを入力します。これはRCUの「スキーマ・パスワード」画面でサービス表コンポーネントに指定したスキーマ(「データベース・スキーマの作成」を参照)のユーザー名およびパスワードです。 デフォルトのユーザー名は |
データベース接続情報の指定が完了したら、「RCU構成の取得」をクリックします。操作に成功すると、「接続結果ログ」に次の出力が示されます。
Connecting to the database server...OK Retrieving schema data from database server...OK Binding local schema components with retrieved data...OK Successfully Done.
ヒント:
「RCUデータ」オプションの詳細は、リポジトリ作成ユーティリティを使用したスキーマの作成のサービス表スキーマの理解に関する項を参照してください。
この画面のその他のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のデータ・ソース・デフォルトに関する項を参照してください
ドメインを作成する製品に関連付けられるJDBCコンポーネント・スキーマは、画面の下半分にリスト表示されます。
スキーマの名前の横のチェック・ボックスを選択して、データ・ソース設定を指定するスキーマを選択します。
「データベース・スキーマの作成」で作成したデータベース・スキーマの情報を画面の上部の各フィールドに入力します。
フィールド | 説明 |
---|---|
ベンダー |
データベースのベンダーを選択します。 |
ドライバ |
データベースへの接続に使用するJDBCドライバを選択します。リストには、選択したデータベース・ベンダーでよく使用されるJDBCドライバが含まれています。 |
DBMS/サービス |
データベースのDBMS名(サービス・タイプ・ドライバを選択している場合はサービス名)を入力します。 |
ホスト名 |
データベースをホストするサーバーの名前を入力します。 |
ポート |
データベースのホストになるサーバーへの接続に使用するポート番号を入力します。 |
スキーマ所有者 |
データベースのOracle API Managerスキーマに接続するためのユーザー名を入力します。これはRCUの「スキーマ・パスワード」画面で指定したスキーマ(「データベース・スキーマの作成」を参照)のユーザー名です。 デフォルトのユーザー名は |
スキーマ・パスワード |
データベースのスキーマに接続するためのパスワードを入力します。これはRCUの「スキーマ・パスワード」画面でサービス表コンポーネントに指定したパスワードです(「データベース・スキーマの作成」を参照)。 |
ヒント:
この画面のその他のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』の「JDBCコンポーネント・スキーマ」に関する項を参照してください。
「JDBCコンポーネント・スキーマ」画面に示される値が、すべてのスキーマに対して適切であることを確認します。前の画面で「RCUデータ」を選択した場合、スキーマ表はすでに適切に移入されている必要があります。
ヒント:
この画面のその他のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のコンポーネント・スキーマのテストに関する項を参照してください
ヒント:
この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のキーストアに関する項を参照してください。
目的のトポロジに応じたドメインの構成を完了するには、「拡張構成」画面で次のオプションを選択します。
管理サーバー
これは、管理サーバーのリスニング・アドレスを適切に構成するために必要です。
ノード・マネージャ
これは、ノード・マネージャを構成するために必要です。
管理対象サーバー、クラスタおよびCoherence
これは、Oracle API Manager管理対象サーバーを構成するために必要です。
「管理サーバー」画面で、「リスニング・アドレス」の横にあるドロップダウン・リストを選択し、管理サーバーが存在するホストのIPアドレスを選択します。「すべてのローカル・アドレス」は使用しないでください。
管理サーバーにサーバー・グループは指定しないでください。
「ノード・マネージャ」画面は、構成するノード・マネージャのタイプと、そのノード・マネージャの資格証明を選択するために使用できます。
ノード・マネージャのタイプとして「ドメインごとのデフォルトの場所」を選択して、ノード・マネージャの資格証明を指定します。
ヒント:
この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のノード・マネージャに関する項を参照してください。
ノード・マネージャのタイプの詳細は、『Oracle WebLogic Serverノード・マネージャの管理』でノード・マネージャの概要に関する項を参照してください。
「管理対象サーバー」画面で、osb_server1
という名前の新しい管理対象サーバーを作成します。
これらのサーバー名は、このドキュメント全体で引用されるため、別の名前を選択したときには、それらの名前を必要に応じて置換してください。
ヒント:
この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』の管理対象サーバーに関する項を参照してください。
「クラスタ」画面を使用して、新しいクラスタを作成します。
apimgr_cluster1
と指定します。デフォルトでは、クラスタ内のサーバー・インスタンスは、ユニキャストを使用して相互に通信します。マルチキャストを使用するようにクラスタの通信を変更する場合は、『Oracle WebLogic Serverクラスタの管理』のユニキャストまたはマルチキャストを選択する際の考慮事項に関する項を参照してください。
新しいクラスタは、Fusion Middleware Controlを使用して作成することもできます。この場合、クラスタ通信(ユニキャストまたはマルチキャスト)は、新しいクラスタの作成時に構成できます。詳細は、『Oracle WebLogic Server Administration Consoleオンラインヘルプ』のクラスタの作成と構成に関する項を参照してください。
ヒント:
この画面のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のクラスタに関する項を参照してください。
「サーバーのクラスタへの割当」画面を使用して、osb_server1
とosb_server2
を新しいクラスタapimgr_cluster1
に割り当てます。
ヒント:
この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のサーバーのクラスタへの割当てに関する項を参照してください。
「Coherenceクラスタ」画面を使用して、ドメインに自動的に追加されるCoherenceクラスタを構成します。Coherenceクラスタのリスニング・ポートとして、デフォルトのポート番号の0をそのまま使用します。
注意:
ユニキャストのリスニング・ポートを0に設定すると、管理対象サーバーの各ポート番号にオフセットが作成されます。このオフセットは5000です。つまり、管理対象サーバーのポート番号として割当て可能な最大許容値は、65535ではなく60535になります。
注意:
Coherenceライセンス情報については、『Oracle Fusion Middlewareライセンス情報ユーザー・マニュアル』のOracle Coherenceクラスタへのクライアント・アクセスに関する項を参照してください。
「マシン」画面を使用して、ドメイン内に新しいマシンを作成します。マシンは、ノード・マネージャでサーバーを起動または停止できるようにするために必要です。
ヒント:
高可用性環境を作成する際に目的のトポロジで必要になるマシンのリストがわかっているときには、この項の手順を実行して、この時点ですべてのマシンを作成できます。詳細は、『高可用性ガイド』のオプションのスケール・アウト手順に関する項を参照してください。
注意:
既存のドメインを拡張している場合は、既存のマシンにサーバーを割り当てることもできます。新しいマシンが不要な場合は、マシンを作成する必要はありません。
ヒント:
この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のマシンに関する項を参照してください。
「サーバーのマシンへの割当」画面を使用して、作成したばかりの新しいマシンに管理サーバーと管理対象サーバーを割り当てます。
ヒント:
この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のサーバーのマシンへの割当てに関する項を参照してください。
「構成サマリー」画面には、これから作成するドメインに関する詳細な構成情報が表示されます。この画面に示された各項目の詳細を調べて、情報に間違いがないことを確認します。
変更が必要な場合は、「戻る」ボタンを使用するか、ナビゲーション・ペインで画面を選択することで任意の画面に戻れます。
ドメイン作成は、「作成」をクリックするまでは開始されません。
ヒント:
この画面のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』の構成サマリーに関する項を参照してください。
この項では、構成の完了後に、ドメインを管理するためにアクセスできるツールについて説明します。
注意:
ドメイン管理に使用する追加のツールの詳細は、『Oracle Fusion Middleware Oracle Fusion Middlewareの管理』のOracle Fusion Middleware管理ツールの概要に関する項を参照してください。
ドメインごとのノード・マネージャを起動するには、DOMAIN_HOME
/bin
ディレクトリに移動します。
UNIXオペレーティング・システムの場合は、次に示すように、nohup
とサンプル出力ファイルnm.out
を使用してノード・マネージャを起動します。
nohup ./startNodeManager.sh > $LOG_DIR/
nm.out&
上記コマンドで、LOG_DIR
はログ・ファイルを格納するディレクトリの場所です。
Windowsオペレーティング・システムの場合は、次のコマンドを実行します。
startNodeManager.cmd
注意:
Windowsオペレーティング・システムの場合は、ノード・マネージャを起動サービスとして実行するように構成することをお薦めします。これによって、システムが再起動されるたびに、ノード・マネージャが自動で起動されます。
詳細は、『Oracle WebLogic Serverノード・マネージャの管理』の起動サービスとしてのノード・マネージャの実行に関する項を参照してください。
ノード・マネージャのその他の構成オプションについては、『Oracle WebLogic Serverノード・マネージャの管理』を参照してください。
管理サーバーを起動するには、DOMAIN_HOME
/bin
ディレクトリに移動します。
UNIXオペレーティング・システムの場合は、次のコマンドを実行します。
./startWebLogic.sh
Windowsオペレーティング・システムの場合は、次のコマンドを実行します。
startWebLogic.cmd
「ドメイン・モードとJDKの指定」で、「ドメイン・モードおよびJDK」画面の「本番モード」を選択した場合は、「管理者アカウントの構成」の「管理者アカウント」画面で指定した管理者ユーザーのログイン資格証明を入力するように求めるプロンプトが表示されます。
ヒント:
管理サーバーの起動の詳細は、『Oracle Fusion Middlewareの管理』で管理サーバーの起動と停止に関する項を参照してください。
本番モードでは、起動アイデンティティ・ファイルを作成することで、管理サーバーの起動時に必要なユーザー名とパスワードの指定を省略できます。詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の管理サーバー用の起動アイデンティティ・ファイルの作成に関する項を参照してください。
管理サーバー・コンソールにアクセスすることで、管理サーバーが稼働中であることを確認できます。URLは「ドメイン・ホームおよび管理サーバーURLを書き込む」の「構成に成功しました」画面のURLに指定されます。
注意:
製品スキーマをホストしているデータベースが稼働中であり、管理サーバーからアクセスできることを確認してください。
http://administration_server_host:administration_server_port/console
デフォルトの管理サーバーのポート番号は7001
です。
管理コンソールの使用方法については、『Oracle Fusion Middlewareの管理』のOracle WebLogic Server管理コンソールの使用のスタート・ガイドを参照してください。