Oracle® Fusion Middleware WebCenter Sitesインストレーション・ガイド 11g リリース1 (11.1.1.8.0) E49672-02 |
|
前 |
次 |
この章では、WebCenter Sites WebアプリケーションをサポートするためのTomcatの構成について説明します。
この章の内容は、次のとおりです。
この項の内容は、次のとおりです。
開発、コンテンツ管理および配信の各環境の要件に応じて、次の手順を完了します。
ステップ1: Tomcat Application Serverの構成
第4.2.1項「Tomcat Serverポートの変更」の説明に従って、デフォルトTomcatポートを変更します。
第4.2.2項「データ・ソースの作成と構成」の説明に従って、データ・ソースを作成および構成します。
第4.2.3項「Javaオプションの設定」の説明に従って、Javaオプションを設定します。
第4.2.4項「クラスパスの設定」の説明に従って、クラスパスを設定します。
第4.2.5項「URIエンコーディングの構成」の説明に従って、URIエンコーディング文字セットを設定します。
サーバーが、複数サーバー環境の一部である場合は、第4.2.6項「ロード・バランシングのためのTomcatサーバーの構成」の説明に従って、jvmRoute
属性を設定します。
Tomcatサーバーが、クラスタ環境の一部である場合は、第4.2.7項「クラスタリングのためのTomcatサーバーの構成」の説明に従って、クラスタリング用にサーバーを構成します。
サーバーがSSLを介して実行されている場合は、第4.2.8項「SSLのためのTomcatサーバーの構成」の説明に従って、SSL用にTomcatサーバーを構成します。
ステップ2: Tomcat Application ServerとサポートされているWebサーバーとの統合
この手順は、次のような場合に必要です。
Apache Web Serverを使用してロード・バランシングされるクラスタ化された環境を作成する。
Tomcatの前にApache Web Serverを配置する。
TomcatをApache Web Serverと統合する手順は、第4.3項「ステップ2: Tomcat Application ServerとサポートされているWebサーバーとの統合」に記載します。
表4-1は、この章で使用されるパスおよびディレクトリを示しています。
この項では、Tomcatインスタンスの起動および停止のコマンドをリストします。
注意: すべてのコマンドは、 |
Tomcatインスタンスを起動する手順は、次のとおりです。
次のコマンドを実行します。
UNIXの場合:
<tomcat_home>/bin/startup.sh
Windowsの場合:
<tomcat_home>/bin/startup.bat
Tomcatインスタンスを停止する手順は、次のとおりです。
次のコマンドを実行します。
UNIXの場合:
<tomcat_home>/bin/shutdown.sh -force
Windowsの場合:
<tomcat_home>/bin/shutdown.bat
この項では、次の手順を完了します。
注意: この項の手順では、UNIXコマンドを使用します。 |
この項では、Tomcatによって使用されるデフォルト・ポートを変更する方法を説明します。同じ物理サーバー上で複数のTomcatサーバーを実行するには、これらのポートを変更し、ポートの競合を回避する必要があります。
Tomcatサーバーを停止します。
テキスト・エディタで<tomcat_home>/conf/server.xml
ファイルを開き、次のポートを変更します。
停止ポート(デフォルト8005
)
このポートは、Tomcatサーバーを停止するときに使用されます。
HTTPポート(デフォルト8080
)
これは、Webアプリケーションにアクセス可能になるメイン・ポートです。
リダイレクト・ポート(デフォルト8443
)
このポートは、HTTPとAJPの両方のコネクタで変更する必要があります。
AJPポート(デフォルト8009
)
このポートは、Apache Webサーバーとの通信に使用できます。
(SSLのみ) SSL HTTPポート(デフォルト8443
)
SSLを使用する場合、このポートをステップ2で使用したものと同じ値に変更します。
変更を保存します。
使用するデータベースに対応するデータ・ソース情報を選択し、必要なJARファイルを<tomcat_home>/lib
ディレクトリに配置します。表4-2のデータ・ソース情報は、次のステップでデータ・ソースを作成するために使用されます。
表4-2 データ・ソース情報
データベース・ドライバ | パラメータ | 値 |
---|---|---|
JTDS (サード・パーティ・ドライバ) |
|
|
DB2 |
|
|
Oracle Thinドライバ |
|
|
テキスト・エディタで<tomcat_home>/conf/server.xml
ファイルを開き、Host
タグ内に次のXMLコードを追加し、パラメータ化されている値をすべて置換します。
<Context path="/<sites_context_root>" docBase="<sites_context_root>" reloadable="true" crossContext="true"> <Resource name="<jndi_name>" auth="Container" type="javax.sql.DataSource" maxActive="100" maxIdle="30" username="<db_user_name>" password="<db_user_password>" driverClassName="<db_driver_class>" url="<db_url>"/> </Context>
Oracle Databaseの場合のサンプル・データ・ソース:
<Context path="/cs" docBase="cs" reloadable="true" crossContext="true"> <Resource name="csDataSource" auth="Container" type="javax.sql.DataSource" maxActive="100" maxIdle="30" username="csuser" password="password" driverClassName="oracle.jdbc.driver.OracleDriver" url="jdbc:oracle:thin:@//127.0.0.1:1521/contentDB"/> </Context>
注意: 前述の例では、データベース接続の最大許容数は、 |
変更を保存します。
この項では、メモリー引数の設定およびWebCenter Sitesに必要なJavaオプションの追加方法について説明します。
テキスト・エディタで<tomcat_home>/bin/setenv.sh
を開き、行CATALINA_OPTS="<java_opts>"
を追加します。<java_opts>
は、空白で区切られた次のオプションのリストです。
-Xms512m -Xmx2048m
これらのオプションで、最小および最大メモリー・ヒープ・サイズが設定されます。これらは推奨されるサイズですが、環境の要件に応じて変更できます。
-XX:MaxPermSize=192m
このオプションで、Permanent世代の容量の最大サイズが設定されます。これは推奨されるサイズですが、環境の要件に応じて変更できます。
-Dfile.encoding=UTF-8
このオプションによってUTF-8ファイル・エンコーディングが指定されます。
-Dnet.sf.ehcache.enableShutdownHook=true
このオプションによって、Ehcache
停止フックが有効化されます。
-Djava.net.preferIPv4Stack=true
このオプションで、IPv4アドレスの使用が指定されます。
-Duser.timezone=UTC
このオプションは、JVMのタイムゾーンの設定に使用されます。すべてのWebCenter Sitesインストールで、この値をUTC
に設定することをお薦めします。ただし、この値がすべてのWebCenter Sitesインストールで同一であるかぎり、任意のタイムゾーンを設定できます。完成したCATALINA_OPTS
は次のようになるはずです。
CATALINA_OPTS="-Xms512m -Xmx2048m -XX:MaxPermSize=192m -Dfile.encoding=UTF-8 -Dnet.sf.ehcache.enableShutdownHook=true -Djava.net.preferIPv4Stack=true -Duser.timezone=UTC"
注意:
|
変更を保存します。
この項では、WebCenter Sitesが必要とするパスを、アプリケーション・サーバー・クラスパスに追加する方法を説明します。
テキスト・エディタで<tomcat_home>/bin/setenv.sh
を開き、行CLASSPATH="<paths>"
を追加します。ここで、<paths>
は、次のパスのコロン(:)で区切られたリストです。
<sites_install_dir>/bin
このパスには、必須のWebCenter SitesおよびCASの構成ファイルが含まれます。このファイルがないと、CAS Webアプリケーションは起動せず、WebCenter Sites管理インタフェースの「管理」タブの「システム・ツール」ノードの機能が低下します。
$JAVA_HOME/lib/tools.jar
このJARファイルは、JDK内にあります。
変更を保存します。
この項では、URIエンコーディングの文字セットをUTF-8に設定する方法を説明します。
テキスト・エディタで<tomcat_home>/conf/server.xml
を開き、次のようにHTTP Connector
タグ内にURIEncoding
属性を追加します。
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />
変更を保存します。
この項では、ロード・バランシング環境の一部となることができるようにTomcatサーバーを構成する方法を説明します。
テキスト・エディタで<tomcat_home>/conf/server.xml
を開き、次のようにEngine
タグ内にjvmRoute
属性を追加します。
<Engine name="Catalina" defaultHost="localhost" jvmRoute="jvm1">
jvmRoute
の値を変更し、それが、ロード・バランシングされるすべての他のTomcatサーバーに対して一意になるようにします。
変更を保存します。
この項では、クラスタの一部となるようにTomcatサーバーを構成する方法を説明します。
テキスト・エディタで<tomcat_home>/conf/server.xml
ファイルを開き、次のXMLコードを、Engine
タグ内の最初のものとなるように追加します。
<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster" channelSendOptions="8"> <Manager className="org.apache.catalina.ha.session.DeltaManager" expireSessionsOnShutdown="false" notifyListenersOnReplication="true"/> <Channel className="org.apache.catalina.tribes.group.GroupChannel"> <Membership className="org.apache.catalina.tribes.membership.McastService" address="228.0.0.4" port="45564" frequency="500" dropTime="3000"/> <Receiver className="org.apache.catalina.tribes.transport.nio.NioReceiver" address="auto" port="4000" autoBind="100" selectorTimeout="5000" maxThreads="6"/> <Sender className="org.apache.catalina.tribes.transport.ReplicationTransmitter"> <Transport className="org.apache.catalina.tribes.transport.nio.PooledParallelSender"/> </Sender> <Interceptor className="org.apache.catalina.tribes.group.interceptors.TcpFailureDetector"/> <Interceptor className="org.apache.catalina.tribes.group.interceptors.MessageDispatch15Interceptor"/> </Channel> <Valve className="org.apache.catalina.ha.tcp.ReplicationValve" filter=""/> <Valve className="org.apache.catalina.ha.session.JvmRouteBinderValve"/> <Deployer className="org.apache.catalina.ha.deploy.FarmWarDeployer" tempDir="/tmp/war-temp/" deployDir="/tmp/war-deploy/" watchDir="/tmp/war-listen/" watchEnabled="false"/> <ClusterListener className="org.apache.catalina.ha.session.JvmRouteSessionIDBinderListener"/> <ClusterListener className="org.apache.catalina.ha.session.ClusterSessionListener"/> </Cluster>
必要に応じて、Membershipアドレスまたはポートを変更します。
各クラスタは、メッセージの競合を回避するために、一意のMembershipアドレスとポートの組合せを持つ必要があります。
1つのクラスタのすべてのメンバーは、Membershipアドレスおよびポートに対して同じ値を持つ必要があります。
必要に応じて、ReceiverポートまたはautoBind
を変更します。
レシーバは、ポートと、ポート+autoBind
の範囲の空きポートにバインドすることで、ポートの競合を自動的に回避します。これらの値のいずれかを必要に応じて変更し、レシーバが使用するポートの範囲を制限します。
変更を保存します。
次のように証明書を生成します。
keytool -genkey -alias tomcat -keyalg RSA –keystore <tomcat_home>/keys/.keystore
-keystore
パラメータを、生成されたキーを格納する場所に設定します。
キーストア・パスワードを求められたら、自身のパスワードを使用するか、デフォルトのchangeit
を使用できます。カスタム・パスワードを入力する場合、server.xml
ファイルの値の変更が必要になります(ステップ2で説明)。
求められたら、姓名、組織名、市区町村、都道府県および国コードを入力し、確認のために「Yes」をクリックします。
次に「Enter key password for <tomcat>
(RETURN if same as keystore password)」が表示されたら、キー・パスワードはキーストア・パスワードと同じであるため、[Enter]キーを押します。
<tomcat_home>/conf/server.xml
を編集し、SSLセクションを非コメント化し、次の属性をSSLコネクタに追加します。
変更を保存します。
サーバーを起動した後、ブラウザにhttps://<tomcat_host>:<ssl_port>
を指定します。
システムが適切に機能している場合、証明書を受け入れるように求められます。証明書を受け入れると、Tomcat索引ページが表示されます。
この項では、Tomcatサーバーを、選択したサポートされているWebサーバーと統合するためのガイドラインを示します。
この項では、Tomcatで使用するために、mod_proxy_ajp
プラグインをApache 2.2.xまたはApache 2.4.x HTTPサーバーで構成する方法について説明します。
mod_so.c
が有効化されていることを確認します。<apache_home>/bin/apachectl -l
を実行します。mod_so.c
が出力されたリストにない場合、-enable-module=so
オプションを指定してApacheを再構築する必要があります。
テキスト・エディタで<apache_home>/config/httpd.conf
を開き、そのファイルの最後に次のものを追加します。
単一サーバー環境
ProxyPass /cas ajp://<tomcat_server_host>:<ajp_port>/cas ProxyPassReverse /cas ajp://<tomcat_server_host>:<ajp_port>/cas ProxyPass /<sites_context_root> ajp://<tomcat_server_host>:<ajp_port>/<sites_context_root> ProxyPassReverse /<sites_context_root> ajp://<tomcat_server_host>:<ajp_port>/<sites_context_root>
複数サーバー環境
<Location /balancer-manager> SetHandler balancer-manager Order Deny,Allow Deny from none Allow from all </Location> <Proxy balancer://cluster> BalancerMember ajp://<tomcat_server_host1>:<ajp_port1> loadfactor=1 route=<jvm_route1> BalancerMember ajp://<tomcat_server_host2>:<ajp_port2> loadfactor=1 route=<jvm_route2> ProxySet stickysession=JSESSIONID </Proxy> ProxyPass /cas balancer://cluster/cas ProxyPassReverse /cas balancer://cluster/cas ProxyPass /<sites_context_root> balancer://cluster/<sites_context_root> ProxyPassReverse /<sites_context_root> balancer://cluster/<sites_context_root>
注意: この例では、バランサマネージャがすべてのアクセスを許可します。セキュリティを高めるために、Apacheのドキュメントを参照して、Deny fromおよびAllow fromの値を変更できます。 AVI Sportsサンプル・サイトをインストールする場合は、各 |
変更を保存します。
次のコマンドで、httpd.conf
ファイルの構文を検証します。
<apache_home>/bin/apachectl -t
Webサーバーを再起動します。