Advanced Management Consoleに対するOracle WebLogic Serverの構成

5 Advanced Management Consoleに対するOracle WebLogic Serverの構成

WebLogic Serverインスタンスでは、データベースにアクセスするために、エージェントおよびデータ・ソースと通信するためのWebサービスを備えています。また、Advanced Management ConsoleとJava使用状況トラッカ・パーサーをAdvanced Management Consoleのサーバー・コンポーネントとして構成するためのユーザー・インタフェース(UI)もあります。

Advanced Management Consoleに対するOracle WebLogic Serverの構成のトピックには、Advanced Management Consoleに対してOracle WebLogic Serverをインストールおよび構成するためのソフトウェア要件を説明する次の項があります。

Oracle WebLogic Serverのソフトウェア要件

Advanced Management Consoleには、Oracle WebLogic ServerとJava SE Development Kit 8ダウンロードが必要です。

Advanced Management ConsoleのみにOracle WebLogic Serverを使用する場合、Oracle WebLogic Server Installers for Developmentで、WebLogic Server 12.2.1など、Oracle WebLogic Server 12.1.3以降に移動して、macOS、WindowsおよびLinuxの配布用Zipオプションを選択します。Oracle WebLogic Serverのライセンスを持っている場合は、Oracle Software DeliveryからOracle WebLogic Server 12.2.1をダウンロードできます。

WebLogic Serverのインストール

Oracle WebLogic Serverをインストールするには様々な方法があります。Oracle WebLogic Serverインストールの例では、Oracle WebLogic Serverのインストール、ドメインの作成、管理サーバーの作成および管理対象サーバーの作成の例が示されています。

データベースによるWebLogic Serverの構成

このトピックには、データベースでOracle WebLogic Serverを構成してJDBCサーバーをデプロイする方法を説明する次の項があります。

MySQLデータベースによるWebLogic Serverの構成

MySQLデータベースによってOracle WebLogic Serverを構成し、ユーザー・データにアクセスしてを変更するためのサービスを提供できます。データベースにはJDBCを使用してアクセスします。

データベースでWebLogic Serverを構成するには:

ブラウザでOracle WebLogic Server管理コンソールを開きます。
- SSLリスニング・ポートがWebLogic Serverインスタンスに構成されている場合は、https://wls-hostname:port/consoleに移動します。次に例を示します。
```
https://localhost:7001/console
```
- SSLリスニング・ポートがWebLogic Serverインスタンスに構成されていない場合は、http://wls-hostname:port/consoleに移動します。次に例を示します。
```
http://localhost:7001/console
```
左側のパネルの「ドメイン構造」ブロックで、「ドメイン」、「サービス」を選択し、「データ・ソース」を選択します。
新しい汎用データ・ソースを作成します。データ・ソース名を設定します(amc2 mysqlなど)。
JNDI名をamc2/db/mysqlに設定します。これは、データ・ソース・オブジェクトを探すためのAdvanced Management Consoleの重要な値です。
データベース・タイプに「MySQL」を選択します。
データベース・ドライバで「MySQLのドライバ(タイプ4)バージョン:com.mysql.jdbc.Driverを使用」を選択します。
「トランザクション・オプション」セクションで、「グローバル・トランザクションのサポート」チェック・ボックスが選択されていないことを確認してください。Advanced Management Consoleではグローバル・トランザクションはサポートされません。
「Advanced Management Consoleに対するMySQLデータベースのインストールと構成」の手順を実行して作成したMySQLデータベース名をデータベース名に設定します。
データベースのhost-nameとportを次のように設定します。
- Oracleデータベースが存在するホスト名。
- portはデフォルトのままにするか、異なる場合はデータベース・ポートに変更します。
MySQLデータベースのデータベースのユーザー名とパスワードを設定します(amc2などのユーザー名と強力なパスワード)。MySQLデータベースのユーザー名とパスワードは、「Advanced Management Consoleに対するMySQLデータベースのインストールと構成」の手順を実行して構成した値です。
「プロパティ」テキスト・ボックスで、次の行を追加してこのJDBC接続のUnicodeを有効にします。

useUnicode=yes

characterEncoding=UTF-8
「ターゲットの選択」ページで、AdminServerまたはAdvanced Management Consoleサーバーをデプロイするサーバーのチェック・ボックスを選択します。
変更を保存するには「終了」をクリックします。
「データ・ソース」表で、直前に作成したデータ・ソースをクリックします。
「接続プール」タブをクリックします。
「最大容量」を50に設定します。
「保存」をクリックして、変更を保存します。

Advanced Management Consoleはデータベース・ユーザーの資格証明を認識する必要はありません。MySQLデータベース・ユーザーの資格証明はアプリケーション・サーバーでデータ・ソース接続を構成する場合にのみ必要です。そのため、ステップ4で述べたJNDI名は設定に対して非常に重要です。

WebLogic Serverをデータベースで構成する場合、データベースのJDBCデータ・ソースをデプロイしてWebLogic Serverに接続します。

OracleデータベースによるWebLogic Serverの構成

OracleデータベースによってOracle WebLogic Serverを構成し、ユーザー・データにアクセスして変更するためのサービスを提供できます。データベースにはJDBCを使用してアクセスします。

OracleデータベースによってWebLogic Serverを構成するには、次のようにします。

ブラウザでOracle WebLogic Server管理コンソールを開きます。
- SSLリスニング・ポートがWebLogic Serverインスタンスに構成されている場合は、https://wls-hostname:port/consoleに移動します。次に例を示します。
```
https://localhost:7001/console
```
- SSLリスニング・ポートがWebLogic Serverインスタンスに構成されていない場合は、http://wls-hostname:port/consoleに移動します。次に例を示します。
```
http://localhost:7001/console
```
左側のパネルの「ドメイン構造」ブロックで、ドメイン・サービスを選択し、「データ・ソース」を選択します。
新しい汎用データ・ソースを作成します。データ・ソース名を設定します。たとえば、amc2 oracleです。
データベースがOracle 12cの場合は、「JNDI名」をamc2/db/oracleに設定します。データベースがOracle 11gの場合には、「JNDI名」をamc2/db/oracle11に設定します。
これは、データ・ソース・オブジェクトを探すためのAdvanced Management Consoleの重要な値です。
データベース・タイプで「Oracle」を選択します。
データベース・ドライバでOracleのインスタンス接続用ドライバ(Thin)を、バージョンで「任意」を選択します。
「トランザクション・オプション」セクションで、「グローバル・トランザクションのサポート」チェック・ボックスが選択されていないことを確認してください。Advanced Management Consoleではグローバル・トランザクションはサポートされません。
「Advanced Management Consoleに対するOracleデータベースのインストールと構成」の手順を実行して作成したOracleデータベース名をデータベース名に設定します。
データベースのhost-nameとportを次のように設定します。
- Oracleデータベースが存在するホスト名。
- portはデフォルトのままにするか、異なる場合はデータベース・ポートに変更します。
ご使用のOracleデータベースのデータベース・ユーザー名とパスワードを設定します。
Oracleデータベースのユーザー名とパスワードは、「Advanced Management Consoleに対するOracleデータベースのインストールと構成」の手順を実行して構成した値です。たとえば、ユーザー名amc2と強力なパスワードです。
URLでportの後のコロン(:)をスラッシュ(/)に変更します。
次に例を示します。
```
 jdbc:oracle:thin:@oracledb-hostname:port/amc2
```
「プロパティ」テキスト・ボックスで、次の行を追加してこのJDBC接続のUnicodeを有効にします。

user=amc2

useUnicode=yes

characterEncoding=UTF-8
「次」をクリックします。
「ターゲットの選択」ページで、AdminServerまたはAdvanced Management Consoleサーバーをデプロイするサーバーのチェック・ボックスを選択します。
変更を保存するには「終了」をクリックします。
「データ・ソース」表で、直前に作成したデータ・ソースをクリックします。
「接続プール」タブをクリックします。
「最大容量」を50に設定します。
「保存」をクリックして、変更を保存します。

Advanced Management ConsoleはOracleデータベース・ユーザーの資格証明を認識する必要はありません。Oracleデータベース・ユーザーの資格証明はアプリケーション・サーバーでデータ・ソース接続を構成する場合にのみ必要です。ステップ4で述べたJNDI名は設定に対して非常に重要です。

WebLogic Serverをデータベースで構成した後で、データベースのJDBCデータ・ソースをデプロイしてWebLogic Serverに接続します。

WebLogic Serverデプロイメント・ライブラリへのJAX-RS 2.0のデプロイ

Advanced Management ConsoleでWebサービス用のJAX-RS 2.0 RESTful Management APIを使用する必要がある場合は、WebLogic Serverデプロイメント・ライブラリにjax-rs-2.0.warファイルをデプロイする必要があります。

WebLogic Server管理コンソールからファイルをデプロイするには、次のようにします。

WebLogic Server管理コンソールにログインします。
左パネルの「ドメイン構造」ブロックから「デプロイメント」を選択します。
「インストール」ボタンをクリックします。
Windowsオペレーティング・システムの場合は、パス%MW_HOME%\wlserver\common\deployable-librariesを入力します。

Linuxオペレーティング・システムの場合は、パス$MW_HOME/wlserver/common/deployable-librariesを入力します。
jax-rs-2.0.warを選択します。
残りのすべての設定に対するデフォルト値をそのまま使用し、「次へ」、「次へ」、「次へ」および「終了」をクリックします。
新規エントリName=jax-rs(2.0) およびType=Libraryの「デプロイメント」セクションで確認します。
「デプロイメント」リストから、jax-rs(2.X.X)、「ターゲット」タブの順にクリックし、管理サーバー、またはAdvanced Management Consoleをデプロイするサーバーの横にあるボックスを選択し、「保存」をクリックします。

WebLogic Server JTAの設定

データベース・アクセスに対するJavaトランザクションのタイムアウト間隔の値を十分に長く設定していない場合、WebLogic Serverでエラーが発生する可能性があります。JavaトランザクションAPI (JTA)を使用してタイムアウト間隔を定義するには、WebLogic Server管理者の資格証明が必要です。

WebLogic Serverドメインのタイムアウトが300秒になるようにJavaトランザクションAPI (JTA)構成を定義するには:

WebLogic Server管理コンソールにログインします。
左側のパネルの「ドメイン構造」ブロックで、「サービス」に移動して、サービスから「JTA」を選択します。
「構成」タブをクリックして、「JTA」サブタブをクリックします。
JavaトランザクションAPI (JTA)のページで、「タイムアウト」の値に300を入力します。

Javaヒープ・サイズおよびプロキシ・サーバーの設定

サーバーからインターネットへの直接アクセスが使用できない場合は、WebLogic Serverに対してプロキシ・サーバーを設定する必要があります。Advanced Management Consoleでは、Javaセキュリティ・ベースラインへのアクセス権が必要です。また、JNLPファイルが企業ネットワーク外にある場合は、それらをイントロスペクトするために、インターネット・アクセスが必要となります。たとえば、OracleチュートリアルからJNLPアプリケーションを起動する場合、情報を正しく表示するには、Advanced Management Consoleで、JNLPファイルおよび参照されるjarをダウンロードする必要があります。

Javaヒープ・サイズおよびプロキシ・サーバーを設定するには:

WebLogic Server管理コンソールにログインします。
管理コンソールで「環境」に移動し、「サーバー」、「管理対象サーバー」の順に選択します。
「構成」タブ、「サーバーの起動」サブ・タブの順にクリックします。
次のVMオプションを「引数」テキスト・フィールドに追加し、ヒープ・サイズおよびプロキシ設定(HTTPSおよびHTTPプロキシ設定)を含めます。
```
-Xmx4G
-Dhttps.proxyHost=host_name -Dhttps.proxyPort=proxy_port
-Dhttp.proxyHost=host_name -Dhttp.proxyPort=proxy_port
-Dhttp.nonProxyHosts=server_hostname|server_IP
```
ノート:
推奨されるとおりにJavaヒープ・サイズを調整する必要があります。4GB以上のヒープ・サイズをお薦めします。-Xmx4Gオプションは、最大ヒープ・サイズを4GBに変更します。ヒープ・サイズが4GBでは32ビットのJVMを起動できないため、64ビットのJVMを使用することをお薦めします。Advanced Management Consoleによって、Javaヒープ・サイズが少ないことが検出されると、ログイン画面に対応する警告メッセージが表示されます。

信頼できるHTTPS証明書

Advanced Management Consoleでは、Advanced Management Consoleサーバーとクライアント(エージェント、Web UI、デプロイメント・ルール・セット・ツール、Javaインストーラ構成)との通信にHTTPSのみを使用します。Advanced Management ConsoleのHTTPS設定では、クライアント側のJava Runtime Environment (JRE)で信頼される有効なHTTPS証明書が必要です。

有効なHTTP証明書が入手可能で、Oracle WebLogic Serverアイデンティティ・キーストアがそれによって設定されていることを確認します。『Oracle Fusion Middleware Oracle WebLogic Server 12.1.3 セキュリティの管理』ガイドのキーストアの構成に関する項を参照してください。

ノート:

自己署名証明書は、デモの場合のみ使用できます。本番システムでは使用できません。

WebLogic Serverのメール通知の設定

Advanced Management Consoleサーバーは、自身の資格証明でエージェントを登録する管理対象デスクトップ・ユーザーに電子メール通知をオプションで送信します。Advanced Management Consoleサーバーは、Oracle WebLogic Serverに組み込まれているJavaMail APIを使用して、Advanced Management Consoleと実際のSMTPメール・サーバーの媒介として機能します。特定のメール・サーバーを使用するには、WebLogic Serverを構成する必要があります。

WebLogic Serverコンソールで電子メール通知設定用にWebLogic Serverを構成するには:

WebLogic Server管理コンソールにログインします。
ドメイン構造ブロックから「サービス」および「メール・セッション」を選択します。
「新規」をクリックして、フォームに入力します。

次の詳細内容でフォームに入力します。

名前: 任意の名前を指定します。
JNDI名: JNDI名をamc2/mailとして指定します。これは、メール・サーバーの設定の重要な値です。
セッションのユーザー名とパスワードを指定します。
JavaMailプロパティを設定します。

mail.transport.protocol=smtp

mail.smtp.ssl.enable=true

mail.smtp.auth=true

mail.smtp.host=<your email host name>
SMTPセッションをトレースするには、mail.debug=trueを設定します。
「次」をクリックし、Advanced Management Consoleがデプロイされるサーバーを選択します。
「終了」をクリックします。

Advanced Management Consoleユーザー・インタフェースの「構成」タブの「設定」サブタブに、WebLogic Serverのメール通知を有効化または無効化するチェック・ボックスがあります。JNDI名が見つからない場合、このチェック・ボックスは無効化され、WebLogic Serverの電子メール通知を有効にできません。

WebLogic Server構成の保護

WebLogic ServerでJavaセキュリティ・マネージャを使用すると、Java仮想マシン(JVM)で実行しているリソースを保護して、Advanced Management Consoleのセキュリティを強化できます。