プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle HTTP Serverの管理
12c (12.1.3)
E56227-07
  ドキュメント・ライブラリへ移動
ライブラリ
製品リストへ移動
製品
目次へ移動
目次
索引へ移動
索引

前
 
次
 

4 Oracle HTTP Serverの実行

この章では、Oracle HTTP Serverの実行方法に関する情報を提供します。ここには、WebLogic環境およびスタンドアロン環境における、サーバー・インスタンスの生成手順と、インスタンスの起動、停止、管理の方法が含まれています。

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

4.1 始める前に

この章で説明するタスクを実行する前に、次の手順を実行する必要があります。

  1. 『Oracle HTTP Serverのインストールと構成』の説明に従って、Oracle HTTP Serverをインストールおよび構成します。

  2. WebLogic ServerドメインでOracle HTTP Serverを実行している場合は、『Oracle WebLogic Serverサーバーの起動と停止の管理』のサーバーの起動と停止に関する項に従ってWebLogic Serverを起動します。


    注意:

    コマンド行からWebLogic Serverを起動すると、多数の警告メッセージがスクロール表示される場合があります。これらのメッセージが表示される場合でも、WebLogic Serverは正常に起動します。

  3. 『Oracle WebLogic Serverノード・マネージャの管理』のノード・マネージャの使用に関する項に従って、ノード・マネージャ(WebLogicドメインおよびスタンドアロン・ドメインの両方に必要)を起動します。

4.2 OHSインスタンスの作成

構成ウィザードを使用すると、ドメインの作成時に複数のOracle HTTP Serverインスタンスを同時に作成できます。WebLogic Serverドメインを作成する場合はインスタンスを作成する必要はありませんが、スタンドアロン・ドメインを作成する場合は少なくとも1つのOracle HTTP Serverインスタンスを作成する必要があります。WebLogic Serverドメインの作成時にインスタンスを作成しないことを選択した場合は、警告が表示されますが、構成プロセスは続行できます。


注意:

予約済の範囲内(通常1024未満)にあるTCPポートを使用するOracle HTTP Serverインスタンスを作成しようとしている場合、サーバーを特権ポートにバインドできるように追加の構成を行う必要があります。詳細は、4.3.2.4項「特権ポートでのOracle HTTP Serverインスタンスの起動(UNIXのみ)」を参照してください。


注意:

Oracle Fusion Middlewareには、多数のWLSTのバージョンが含まれています。この章のすべての手順で使用されているWLSTコマンドは、WLST実装をORACLE_HOME/ohs/common/bin/で実行する場合のみ機能します。

4.2.1 WebLogic Serverドメインでの管理対象インスタンスの作成

カスタムのWebLogic Scripting Tool (WLST)コマンド createOHSInstance()、あるいはOracle Fusion Middlewareインフラストラクチャの一部としてインストールされているFusion Middleware Controlを使用して、WebLogic Serverドメインの中に管理対象のOracle HTTP Serverインスタンスを生成できます。次の項で、これらの手順について説明します。


注意:

WebLogic Serverドメインで作業している場合は、3.6項「WebLogic Scripting Toolの使用」の説明に従ってOracle HTTP ServerのカスタムWLSTコマンドを使用することを推奨します。これらのコマンドによって、優れたエラー・チェックや自動ポート管理などが提供されます。

4.2.1.1 WLSTを使用したインスタンスの作成

WLSTを使用してWebLogic ServerドメインでOHSインスタンスを作成するには、次の手順を実行します。

  1. コマンド行からWLSTを起動します。

    Linux: $ORACLE_HOME/ohs/common/bin/wlst.sh

    Windows: $ORACLE_HOME\ohs\common\bin\wlst.cmd

  2. WLSTに接続します。

    • WebLogic Serverドメインでは:

      > connect('loginID', 'password', '<adminHost>:<adminPort>')
      

      例:

      > connect('weblogic', 'welcome1', 'abc03lll.myCo.com:7001')
      
  3. インスタンスおよびドメイン作成時に割り当てられたマシン名を指定してcreateOHSInstance()コマンドを使用し、インスタンスを作成します。

    > createOHSInstance(instanceName='ohs1', machine='abc03lll.myCo.com', [listenPort=XXXX], [sslPort=XXXX], [adminPort=XXXX]) 
    

    注意:

    ノード・マネージャが停止している場合は、createコマンドが部分的に実行されます。構成ファイルのマスター・コピーがOHS/componentNameに表示されます。ノード・マネージャが再開されると、システムが再同期化を行い、ファイルのランタイム・コピーがOHS/instances/componentNameに表示されます。

    例:

    > createOHSInstance(instanceName='ohs1', machine='abc03lll.myCo.com')
    

    注意:

    ポート番号を指定しない場合は、番号が自動的に割り当てられます。


関連項目:

WebLogic Scripting Tool (WLST)の使用の詳細は、『WebLogic Scripting Toolの理解』を参照してください。

4.2.1.2 Fusion Middleware Controlを使用したインスタンスの作成

Oracle Fusion Middlewareインフラストラクチャの一部としてインストールされているFusion Middleware Controlを使用して、WebLogic Serverドメインの中にOracle HTTP Serverインスタンスを生成するには、次の手順に従ってください。

  1. Fusion Middleware Controlにログインし、Oracle HTTP Serverインスタンスを作成するWebLogic Serverドメインのシステム・コンポーネント・インスタンスのホームページに移動します。

  2. WebLogic Serverドメインのメニューを開き、「管理」を選択してから、「OHSの作成/削除」を選択します。


    注意:

    「OHSの作成/削除」は、Oracle HTTP Serverドメイン・テンプレートを使用してドメインを拡張している場合のみ表示されます。そうでない場合は、このコマンドを使用できません。

    cre_del_ohs.gifの説明が続きます
    図「cre_del_ohs.gif」の説明

    「OHSインスタンス」ページが表示されます。

    cre_ohs_inst_page_new.gifの説明が続きます
    図「cre_ohs_inst_page_new.gif」の説明

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

    「OHSインスタンスの作成」ページが表示されます。

    cre_ohs_inst_page.gifの説明が続きます
    図「cre_ohs_inst_page.gif」の説明

  4. 「インスタンス名」で、Oracle HTTP Serverインスタンスの一意の名前(ohs4など)を入力します。

  5. 「マシン名」で、ドロップダウン・コントロールをクリックし、インスタンスを関連付けるマシンを選択します。

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

    「OHSインスタンス」ページが再表示され、確認メッセージと新しいインスタンスが示されます。ポート番号は自動的に割り当てられます。

    cre_inst_conf.gifの説明が続きます
    図「cre_inst_conf.gif」の説明

インスタンスの作成後、「OHSインスタンス」ページの列に、そのインスタンスに対して下矢印が表示されます。

cre-status.gifの説明が続きます
図「cre-status.gif」の説明

これは、インスタンスが実行されていないことを示します。インスタンスの起動手順は、4.3.2項「Oracle HTTP Serverインスタンスの起動」を参照してください。起動後、矢印は上向きになります。

4.2.1.3 インスタンスのプロビジョニング

インスタンスの作成後、インスタンスはDOMAIN_HOME内でプロビジョニングされます。

  • マスター・コピーは次の場所にあります。

    DOMAIN_HOME/config/fmwconfig/components/OHS/componentName

  • ランタイムは次の場所にあります。

    DOMAIN_HOME/config/fmwconfig/components/OHS/instances/componentName

    実行時にインスタンスを提供するために、ノード・マネージャが実行中である必要があります。

作成直後、報告されるOHSインスタンスの状態は、インスタンスが作成された方法によって異なります。

  • createOHSInstance()が使用された場合、報告されるインスタンスの状態はSHUTDOWNになります。

  • 構成ウィザードを使用した場合、報告されるインスタンスの状態はUNKNOWNになります。

4.2.2 スタンドアロン・ドメイン・インスタンスの作成

サーバー構成時にドメインとして「スタンドアロン」を選択した場合、構成ウィザードによりドメインが作成されますが、このプロセス中に少なくとも1つのOracle HTTP Serverインスタンスを作成する必要があります。詳細は、『Oracle HTTP Serverのインストールと構成』を参照してください。

4.2.3 共有ファイル・システム上で生成されたインスタンスにパフォーマンス問題が生じた場合

NFS(ネットワーク・ファイル・システム)を含む共有ファイルシステム上でOracle HTTP Serverインスタンスを生成する際に、機能上や性能上の問題が生じた場合には、デフォルト構成のファイルシステム・アクセスに起因する可能性があり、その場合には、ご使用のオペレーティング・システムに合わせてhttpd.confファイルを更新する必要があります。このファイルの更新の詳細は、5.3.9項「共有ファイルシステムでのOracle HTTP Serverコンポーネント構成の更新」を参照してください。

4.3 基本的なOHSタスクの実行

次のタスクに対してはFusion Middleware ControlまたはWebLogic Scripting Toolを使用できます。

WLSTコマンドの使用について

WLSTを使用する予定がある場合は、このツールに精通しておく必要があります。次の点にも注意する必要があります。

  • この項で説明されている、WebLogic Serverドメインで使用されるオンラインWLSTコマンドは、これらのコマンドをORACLE_HOME/ohs/common/bin/wlst.sh (Windowsの場合はwlst.cmd)にあるWLST実装から実行する場合のみ動作します。

  • スタンドアロン・バージョンのOracle HTTP Serverを実行している場合、同じくORACLE_HOME/ohs/common/bin/wlst.sh (Windowsの場合はwlst.cmd)にあるオフライン(または"エージェント")WLSTコマンドを使用する必要があります。これらのコマンドについては、それぞれの適切な箇所で説明します。

詳細は、『Oracle® Fusion Middleware管理者ガイド』のOracle WebLogic Scripting Tool (WLST)の使用のスタート・ガイドを参照してください。

4.3.1 PIDファイルの理解

Oracle HTTP Serverは起動時に、親httpdプロセスのプロセスID (PID)を、次のディレクトリにあるhttpd.pidファイルに書き込みます。

DOMAIN_HOME/servers/<componentName>/logs

管理者は、デーモンの再起動時と終了時にプロセスIDを使用できます。プロセスが異常停止した場合、killコマンドを使用してhttpd子プロセスを停止する必要があります。デフォルトのPIDファイルの名前またはその場所を変更することはできません。

httpd.confのPidFileディレクティブでは、PIDファイルの場所を指定しますが、このディレクティブの値は変更しないでください


注意:

PidFileディレクティブを編集する場合、UNIXおよびLinuxプラットフォームでは、ORACLE_HOME/ohs/bin/apachectlファイルを編集してPIDファイルの新しい場所を指定する必要もあります。


関連項目:

PidFileディレクティブの詳細は、次のApache HTTP Serverのドキュメントを参照してください。

http://httpd.apache.org/docs/current/mod/mpm_common.html#pidfile


4.3.2 Oracle HTTP Serverインスタンスの起動

この項では、Fusion Middleware ControlおよびWLSTを使用してOracle HTTP Serverを起動する方法について説明します。

4.3.2.1 Fusion Middleware Controlを使用したOracle HTTP Serverインスタンスの起動

Fusion Middleware Controlを使用してOracle HTTP Serverを起動するには、Oracle HTTP Serverのホームページに移動し、次のいずれかの操作を実行します。

  • 「Oracle HTTP Server」メニューから次の手順を実行します。

    1. 「コントロール」を選択します。

    2. 「コントロール」メニューから「起動」を選択します。

  • 「ターゲット・ナビゲーション」ツリーから次の手順を実行します。

    1. 起動するOracle HTTP Serverインスタンスを右クリックします。

    2. 「コントロール」を選択します。

    3. 「コントロール」メニューから「起動」を選択します。

  • ページ・ヘッダーから「起動」を選択します。

    インスタンスがUNKNOWNの状態で起動します。

4.3.2.2 WLSTを使用したOracle HTTP Serverインスタンスの起動

WLSTを使用してシステム・コンポーネント・インスタンス内のすべてのOracle HTTP Serverコンポーネントを起動するには(この手順では、4.2項「OHSインスタンスの作成」の説明に従ってOHSインスタンスが作成され、WLSTが実行中であると想定しています)、次に示すようにWebLogic Serverドメインでstart()コマンドを使用するか、またはスタンドアロン・ドメインに対してはnmStart()を使用します。


注意:

  • これらのコマンドを機能させるには、ノード・マネージャが実行中である必要があります。ノード・マネージャが停止している場合は、エラー・メッセージが表示されます。

  • スタンドアロン・ドメインの場合、serverTypeは必須です。これが含まれていないと、startWebLogicを検出できないことを示すエラーがスローされます。


ドメイン 構文
WebLogic
start('instanceName')
または
nmStart(serverName='name', serverType='type')
start('ohs1')
または
nmStart(serverName='ohs1', serverType='OHS')
スタンドアロン
nmStart(serverName='name', serverType='type')
nmStart(serverName='ohs1', serverType='OHS')

インスタンスの作成にcreateOHSInstance()が使用されている場合(4.2項「OHSインスタンスの作成」)、最初に報告されるインスタンスの状態はSHUTDOWNになります。

4.3.2.3 コマンド行を使用したOracle HTTP Serverインスタンスの起動

次のコマンドを入力すると、コマンド・ラインからOracle HTTP Serverを直接(つまりWLSTを起動せずに)起動できます。

Linux: $DOMAIN_HOME/bin/startComponent.sh componentName

Windows: %DOMAIN_HOME%\bin\startComponent.cmd componentName

例:

$DOMAIN_HOME/bin/startComponent.sh ohs1

startComponentスクリプトはノード・マネージャとコンタクトし、nmStart()コマンドを実行します。

数秒後にノード・マネージャのパスワードの入力を要求されます。パスワードを入力し、[Enter]を押します。

Successfully started server componentName...
Successfully disconnected from Node Manager...

Exiting WebLogic Scripting Tool.

注意:

起動時に奇妙なシステム・メッセージが表示されても、無視して構いません。

4.3.2.3.1 ノード・マネージャのパスワードの格納

startComponent.sh/.cmdを使用してサーバーを起動するたびにノード・マネージャのパスワードを入力する手間を省くには、初めて起動する際にstoreUserConfigオプションを使用します。次の手順を実行します。

  1. プロンプトに次のコマンドを入力します。

    $DOMAIN_HOME/bin/startComponent.sh componentName storeUserConfig
    

    システムによりノード・マネージャのパスワードの入力を要求されます。

  2. パスワードを入力します。

    システムは次のメッセージにより応答します。

    Creating the key file can reduce the security of your system if it is not kept in a secured location after it is created. Creating new key...The username and password that were used for this WebLogic NodeManager connection are stored in $HOME/.wlst/nm-cfg-myDomainName.props and $HOME /.wlst/nm-key-myDomainName.props. 
    

4.3.2.4 特権ポートでのOracle HTTP Serverインスタンスの起動(UNIXのみ)


警告:

この手順が完了すると、同じグループのユーザーとして、このOracleホームから実行されている任意のOracle HTTP Serverプロセスを特権ポートにバインドできるようになります。


UNIXシステムでは、予約済の範囲内(通常1024未満)にあるTCPポートは、root権限を持つプロセスによってのみバインドできます。Oracle HTTP Serverは常に非rootユーザー(Oracle Fusion Middlewareをインストールしたユーザー)として実行されます。UNIXで、Oracle HTTP Serverを特権ポートにバインドできるようにするには、特別な構成が必要です。

root権限を持たないプロセスとして、Oracle HTTP Serverが予約済の範囲内にあるポート(デフォルト・ポート80またはポート443など)でリスニングできるようにするには、Oracle HTTP Serverマシンごとに次の1回かぎりのセットアップを使用します。

  1. Oracle HTTP Serverを起動したときと同じユーザーとして次を入力することで、一時的なcap.oraファイルを作成します。

    echo `id -ng`: bind  > /tmp/cap.ora
    

    注意:

    手順2と3は、rootユーザーとして実行する必要があります。rootアクセス権を持たない場合は、システム管理者にこれらの手順を実行してもらいます。

  2. 次の手順を実行することでORACLE_HOME/oracle_common/bin/hasbindファイルを更新します。

    1. 次のようにしてファイルの所有権をrootに変更します。

      chown root $ORACLE_HOME/oracle_common/bin/hasbind
      
    2. ファイルの権限を次のように変更します。

      chmod 4755 $ORACLE_HOME/oracle_common/bin/hasbind
      

      注意:

      上の例では、値4はsetuidビットを参照しています。Oracle HTTP Serverを特権ポートにバインドするには、suidオプションを指定してNFSファイル・システムがマウントされていることを確認してください。nosuidオプションを指定してファイル・システムがマウントされている場合、特権ポートは使用されません。

  3. 次の手順を実行することで、/etc/cap.oraファイルを生成します。

    1. /etc/cap.oraが存在しない場合、手順1で作成した一時的なcap.oraファイルを/etc/ディレクトリにコピーします。

      cp /tmp/cap.ora /etc/cap.ora
      

      /etc/cap.oraが存在する場合、手順1で作成した一時ファイルの内容を既存の/etc/cap.oraファイルに追加します。

      cat /tmp/cap.ora >> /etc/cap.ora
      
    2. /etc/cap.oraファイルの権限を次のように変更します。

      chmod 644 /etc/cap.ora
      
    3. 次のようにしてファイルの所有権をrootに変更します。

      chown root /etc/cap.ora
      

    ルート権限が必要な手順が完了しました。

  4. 必要な場合は、手順1で作成した一時的なcap.oraを削除します。

    rm /tmp/cap.ora
    
  5. 7.4項「ポートの管理」の説明に従って、Oracle HTTP Serverのポート設定を変更します。

  6. 4.3.2項「Oracle HTTP Serverインスタンスの起動」で説明されている起動方法のいずれかを使用することで、インスタンスを起動(または再起動)します。

4.3.3 Oracle HTTP Serverインスタンスの停止

この項では、Fusion Middleware ControlおよびWLSTを使用してOracle HTTP Serverを停止する方法について説明します。Oracle HTTP Serverが停止すると、他のサービスも影響を受ける場合がある点に注意してください。

4.3.3.1 Fusion Middleware Controlを使用したOracle HTTP Serverインスタンスの停止

Fusion Middleware Controlを使用してOracle HTTP Serverを停止するには、Oracle HTTP Serverのホームページに移動し、次のいずれかの操作を実行します。

  • 「Oracle HTTP Server」メニューから次の手順を実行します。

    1. 「コントロール」を選択します。

    2. 「コントロール」メニューから「停止」を選択します。

  • 「ターゲット・ナビゲーション」ツリーから次の手順を実行します。

    1. 停止するOracle HTTP Serverコンポーネントを右クリックします。

    2. 「コントロール」を選択します。

    3. 「コントロール」メニューから「停止」を選択します。

  • ページ・ヘッダーから「停止」を選択します。

4.3.3.2 WLSTを使用したOracle HTTP Serverインスタンスの停止

WLSTを使用してOracle HTTP Serverを停止するには、スクリプティング・ツール内から次のコマンドのいずれかを使用します。


注意:

  • これらのコマンドを機能させるには、ノード・マネージャが実行中である必要があります。ノード・マネージャが停止している場合は、エラー・メッセージが表示されます。

  • スタンドアロン・ドメインの場合、serverTypeは必須です。これが含まれていないと、startWebLogicを検出できないことを示すエラーがスローされます。


ドメイン 構文
WebLogic
shutdown('serverName')
shutdown('ohs1')
スタンドアロン
nmKill(serverName='serverName', serverType='type')Foot 1 
nmKill(serverName='ohs1', serverType='OHS')

脚注 1 nmKill()もWebLogicドメインで動作します。


警告:

パラメータを指定せずにshutdown()を実行すると、WebLogic Serverが終了し、WLSTを終了します。Oracle HTTP Serverは引き続き実行されます。回復するには、WebLogic Serverを再起動し、WLSTを立ち上げ、AdminServerに再接続します。次に、Oracle HTTP Serverインスタンス名でシャットダウンを再実行します。


4.3.3.3 コマンド行からのOracle HTTP Serverインスタンスの停止

次のコマンドを入力すると、コマンド・ラインからOracle HTTP Serverを直接(つまりWLSTを起動せずに)停止できます。

$DOMAIN_HOME/bin/stopComponent.sh componentName

例:

$DOMAIN_HOME/bin/stopComponent.sh ohs1

このコマンドは、WLSTを起動して、WLSTにnmKill()コマンドを実行するように指示します。ノード・マネージャが実行中ではない場合には、stopComponentコマンドは動作しません。

数秒後、(4.3.2.3.1項「ノード・マネージャのパスワードの格納」に記載されているように、storeUserConfigオプションを使用してノード・マネージャを開始していない場合には)ノード・マネージャのパスワードの指定が求められます。パスワードを入力します。サーバーが停止すると、システムは次のように応答します。

Successfully killed server componentName...
Successfully disconnected from Node Manager...

Exiting WebLogic Scripting Tool.

4.3.4 Oracle HTTP Serverインスタンスの再起動

Oracle HTTP Serverを再起動すると、Apache親プロセスが子プロセスに対して現在のリクエストの後に終了する(リクエストの処理中でなければ即時に終了する)ように指示します。再起動時に、親プロセスはその構成ファイルを再び読み取り、そのログ・ファイルを再び開きます。それぞれの子プロセスが終了するたびに、親プロセスは、新しく生成された構成ファイルの子プロセスでそれらの子プロセスを置き換えます。新しい子プロセスは即時に新しいリクエストの処理を開始します。

次の項では、Fusion Middleware ControlおよびWLSTを使用してOracle HTTP Serverを再起動する方法について説明します。

4.3.4.1 Fusion Middleware Controlを使用したOracle HTTP Serverインスタンスの再起動

Fusion Middleware Controlを使用してOracle HTTP Serverを再起動するには、Oracle HTTP Serverのホームページに移動し、次のいずれかの操作を実行します。

  • 「Oracle HTTP Server」メニューから次の手順を実行します。

    1. 「コントロール」を選択します。

    2. 「コントロール」メニューから「再起動」を選択します。

  • 「ターゲット・ナビゲーション」ツリーから次の手順を実行します。

    1. 停止するOHSインスタンスを右クリックします。

    2. 「コントロール」を選択します。

    3. 「コントロール」メニューから「再起動」を選択します。

4.3.4.2 WLSTを使用したOracle HTTP Serverインスタンスの再起動

WLSTを使用してOHSを再起動するには、softRestart()コマンドを使用します。スクリプト・ツール内から次のコマンドのいずれかを入力します。


注意:

  • WebLogicドメインとスタンドアロン・ドメインでは、これらのコマンドが動作するにはノード・マネージャが起動している(すなわち、状態がRUNNINGである)必要があります。ノード・マネージャが停止している場合は、エラー・メッセージが表示されます。

  • スタンドアロン・ドメインの場合は、すべてのパラメータが必須です。これらが含まれていないと、startWebLogicを検出できないことを示すエラーがスローされます。


ドメイン 構文
WebLogic
softRestart('serverName')
softRestart('ohs1')
スタンドアロン
nmSoftRestart(serverName='name', serverType='type')
nmSoftRestart(serverName='ohs1', serverType='OHS')

4.3.5 実行中のOracle HTTP Serverインスタンスのステータスの確認

この項では、実行中のOracle HTTP Serverインスタンスのステータスを確認する方法について説明します。Oracle Fusion Middlewareインフラストラクチャの一部としてインストールされているFusion Middleware Controlから、またはWLSTを使用して、この情報を確認できます。

4.3.5.1 Fusion Middleware Controlを使用したサーバー・ステータスの確認

「Oracle HTTP Server」ページのヘッダーの左上角にある上下矢印は、選択したサーバー・インスタンスが実行中であるかどうかを示します。次のイメージは、サーバー・インスタンス(この場合は「ohs2」)が実行中であることを示す上矢印を表示しています。

up_arrow.gifの説明が続きます
図「up_arrow.gif」の説明

次のイメージは、サーバー・インスタンス(この場合は「ohs2」)が実行中でないことを示す下矢印を表示しています。

down_arrow.gifの説明が続きます
図「down_arrow.gif」の説明

4.3.5.2 WLSTを使用したサーバー・ステータスの確認

WebLogic Serverドメインでは、createOHSInstance()を使用してOracle HTTP Serverインスタンスを作成している場合、その初期状態(インスタンスを起動する前の状態)はSHUTDOWNになります。

構成ウィザードを使用してインスタンス(WebLogic Serverドメインとスタンドアロン・ドメインの両方)を生成した場合、初期状態(インスタンスを起動する前の状態)はUNKNOWNになります。

WLSTを使用して実行中のOracle HTTP Serverインスタンスのステータスを確認するには、WLST内から次のいずれかを入力します。


注意:

  • これらのコマンドを機能させるには、ノード・マネージャが実行中である必要があります。ノード・マネージャが停止している場合は、エラー・メッセージが表示されます。WebLogic Serverドメインでノード・マネージャが停止した場合、インスタンスの実際の状態に関係なく、状態はUNKNOWNに戻ります。また、state()は、ノード・マネージャに接続できないことをユーザーに通知しません。

  • 他のWLSTコマンドとは異なり、state()はノード・マネージャが停止したことをユーザーに通知しないため、インスタンスが本当にUNKNOWN状態なのか、ノード・マネージャが停止しただけなのかを区別する方法がありません。

  • スタンドアロン・ドメインの場合は、すべてのパラメータが必須です。これらが含まれていないと、startWebLogicを検出できないことを示すエラーがスローされます。


ドメイン 構文
WebLogic
state('serverName')
state('ohs1')
スタンドアロン
nmServerStatus(serverName='name', serverType='type')
nmServerStatus(serverName='ohs1', serverType='OHS')


注意:

このコマンドは、存在しないコンポーネントとUNKNOWN状態の実在するコンポーネントを区別しません。したがって、存在しないインスタンスを入力した場合(タイプミスなど)には、UNKNOWN状態が返ります。

4.3.6 Oracle HTTP Serverインスタンスの削除

WebLogic Serverドメインとスタンドアロン・ドメイン両方のOracle HTTP Serverインスタンスを削除できます。

4.3.6.1 WebLogic ServerドメインでのOracle HTTP Serverインスタンスの削除

WebLogic Serverドメインでは、カスタムのWLSTコマンド deleteOHSInstance()、あるいはOracle Fusion Middlewareインフラストラクチャの一部としてインストールされているFusion Middleware Controlを使用できます。次の項で、これらの手順について説明します。

4.3.6.1.1 WLSTを使用したインスタンスの削除

WebLogic Serverドメインにいる場合は、カスタムWLSTコマンドdeleteOHSInstance()を使用して、Oracle HTTP Serverインスタンスを削除できます。このコマンドを使用すると、次のようになります。

  • 選択したインスタンスの情報がconfig.xmlから削除されます。

  • すべてのOHS構成ディレクトリおよびその内容が削除されます(OHS/instanceNameやOHS/instances/instanceNameなど)。

  • 削除されたインスタンスに関連付けられているすべてのログファイルが削除されます。

  • 削除されたインスタンスのすべての状態情報が削除されます。


注意:

ノード・マネージャが停止している場合、deleteOHSInstance()を使用してインスタンスを削除することはできません。

WLSTを使用してインスタンスを削除するには、次の手順を実行します。

  1. 4.3.2.2項「WLSTを使用したOracle HTTP Serverインスタンスの起動」の説明に従ってWLSTに接続します。

  2. コマンド・プロンプトで次のように入力

    deleteOHSInstance(instanceName='instanceName')
    

    たとえば、ohs1という名前のOHSインスタンスを削除するには、次のコマンドを使用します。

    deleteOHSInstance(instanceName='ohs1')
    

UNKNOWNまたはRUNNING状態のOHSインスタンスは削除できません。

4.3.6.1.2 Fusion Middleware Controlを使用したインスタンスの削除

Fusion Middleware Controlを使用してOracle HTTP Serverインスタンスを削除するには、次の手順を実行します。


注意:

実行中のOracle HTTP Serverインスタンスは削除できません。インスタンスが実行中の場合は、4.3.3項「Oracle HTTP Serverインスタンスの停止」の説明に従ってインスタンスを停止してから、次の手順を続行します。

  1. Fusion Middleware Controlにログインし、Oracle HTTP Serverインスタンスを削除するWebLogic Serverドメインのシステム・コンポーネント・インスタンスのホームページに移動します。

  2. WebLogic Serverドメインのメニューを開き、「管理」を選択してから、「OHSの作成/削除」を選択します。

    「OHSインスタンス」ページが表示されます。

  3. 削除するインスタンスを選択して、「削除」をクリックします。

    確認を求めるウィンドウが表示されます。

  4. 「はい」をクリックして削除を完了します。

    選択したOracle HTTP Serverインスタンスが削除されたことを示す情報メッセージを備えた「OHSインスタンス」ページが表示されます。

4.3.6.2 スタンドアロン・ドメインからのOracle HTTP Serverインスタンスの削除

構成ウィンドウを使用することによって、スタンドアロン・ドメイン内のOracle HTTP Serverインスタンスを削除できます(そのインスタンスがドメイン内の唯一のインスタンスでない場合)。構成ウィンドウは常に、スタンドアロン・ドメイン内に少なくとも1つのOracle HTTP Serverインスタンスを必要とするため、ドメイン内に唯一存在するインスタンスについては削除することができません。スタンドアロン・ドメイン内で唯一のインスタンスを削除する場合は、かわりにドメイン・ディレクトリ全体を完全に削除する必要があります。

構成ウィンドウを使用したOracle HTTP Serverインスタンスの削除は、実際には部分削除にすぎません(また、deleteOHSInstance()を使用してWebLogic Serverドメイン側で発生する削除方法との一貫性がありません。4.3.6.1.1項「WLSTを使用したインスタンスの削除」を参照してください)。構成ウィザードを使用してスタンドアロン・インスタンスを削除すると、次のようになります。

  • 特定のインスタンスに関する情報がconfig.xmlから削除されるため、このインスタンスは有効として認識されなくなります。別の更新を行うために構成ウィザードを再度起動したときに、削除されたインスタンスが表示されません。

  • 削除されたインスタンス用にコンパイルされたログは、DOMAIN_HOME/servers/ohs1..にそのまま残されます。その後、同じ名前の新しいインスタンスが作成された場合、そのインスタンスはこれらのファイルへのロギングを継承し、継続します。

  • 削除されたインスタンスの構成ディレクトリとその内容は削除されずDOMAIN_HOME/config/fmwconfig/components/OHS/instanceNameおよびDOMAIN_HOME/config/fmwconfig/components/OHS/instances/instanceNameにそのまま残されます。両方のディレクトリで唯一の変更点は、httpd.conf becomes httpd.conf.bak、ssl.conf becomes ssl.conf.bakおよびadmin.conf becomes admin.conf.bakファイルの名前が変更されることです。これにより、インスタンスが起動されるのを防ぎます。(削除したインスタンスと同じ名前を持つ新しいインスタンスを作成する場合、この情報は上書きされますが、*.bakファイルは残ります)。

  • 削除されたインスタンスの状態情報は、DOMAIN_HOME/system_components/..にそのまま残されます。その後、同じ名前の新しいインスタンスが作成された場合、そのインスタンスは古いインスタンスの状態を継承します。UNKNOWN状態で起動するのではなく、最初からSHUTDOWNまたはFAILED_NOT_RESTARTABLE状態になる場合もあります。

スタンドアロン・ドメインのOracle HTTP Serverインスタンスを削除するには、次の手順を実行します。

  1. 実行中のすべてのインスタンスを停止します(4.3.3項「Oracle HTTP Serverインスタンスの停止」を参照してください)。構成ウィザードはOracle HTTP Serverインスタンスを確認しないため、削除前には、すべてのインスタンスが確実に停止していることを確認する必要があることに注意してください。

  2. ノード・マネージャが実行中である場合は停止させます。

  3. 構成ウィザードを起動し(『Oracle HTTP Serverのインストールと構成』を参照してください)、次の手順を実行します。

    1. 「既存ドメインの更新」を選択し、ドメインへのパスを選択します。

    2. 「テンプレート」画面と「JDKの選択」画面の両方を、それぞれで「次」をクリックすることによってスキップします。

    3. 「システム・コンポーネント」画面で、削除するインスタンスを選択し、「削除」をクリックします。

      選択したインスタンスが削除されます。

    4. 「次」をクリックし、「OHSサーバー」画面で、再度「次」をクリックします。

    5. 「構成のサマリー」画面で、選択したインスタンスが削除されていることを確認し、「更新」をクリックします。

    6. 「成功」画面で、「終了」をクリックします。

4.4 Oracle HTTP Serverのリモート管理

スタンドアロン環境で実行されているOracle HTTP Serverは、別のマシンで実行されている、コロケートされたOracle HTTP Serverの実装でリモート管理できます。この機能によって、WebLogic Scripting Tool (WLST)、あるいはOracle Fusion Middlewareインフラストラクチャの一部としてインストールされているFusion Middleware Controlを使用して、リモート・マシンからコンポーネントの起動、再起動、構成が行えます。この項では、 Oracle HTTP Serverをリモートから実行する設定方法について説明します。

4.4.1 リモート環境の設定

次の指示では、リモート環境の設定方法について説明します。これにより、1つのマシンにインストールされているOracle HTTP Serverを別のマシンのインストールから実行できます。この項には次の情報が含まれます:

4.4.1.1 ホストの要件

Oracle HTTP Serverをリモート管理するには、次のように複数のホストを別々のマシンにインストールする必要があります。

  • コロケート・インストール(この例では、このインストールをホスト1と呼びます)。

  • スタンドアロン・インストール(ホスト2)。ホスト2のスタンドアロンMW_HOMEへのパスは、ホスト1のコロケートされたMW_HOMEと同じである必要があります。例:

    /scratch/user/work
    

4.4.1.2 タスク1: ホスト1での拡張ドメインの設定

次の手順では、拡張ドメインを設定して、コロケートされたバージョンのOracle HTTP Server (ホスト1)のデータベースにリンクする方法について説明します。

  1. Repository Configuration Utility (RCU)を使用して、拡張ドメイン用のデータベースを設定およびインストールします。詳細は、Oracle Fusion Middlewareリポジトリ作成ユーティリティによるスキーマの作成を参照してください。

  2. 構成ウィザードを起動して拡張ドメインを作成します。表4-1で指定した値を使用します。

    表4-1 拡張ドメインの設定

    対象 選択または入力する値

    ドメインの作成

    「新規ドメインの作成」。そのパスを指定します(たとえば、MW_HOME/user_projects/domains/ohs1_domain)。

    テンプレート

    Oracle HTTP Server (コロケート)

    アプリケーションの場所

    デフォルト

    管理者アカウント

    ユーザー名とパスワード(たとえば、weblogicwelcome1)

    データベース構成タイプ

    RCUデータ。続いて、「RCU構成の取得」「次へ」をクリックします。

    オプションの構成

    項目は次のとおりです。

    • 管理サーバー

    • ノード・マネージャ

    • システム・コンポーネント

    • デプロイメントおよびサービス

    管理サーバー

    リスニング・アドレス(「すべてのローカル・アドレス」またはホスト1用の有効な名前かアドレス)およびポート

    ノード・マネージャ

    「ドメイン当たり」。ノード・マネージャの資格証明を指定します(たとえば、weblogicwelcome1)。

    システム・コンポーネント

    「追加」し、コンポーネント・タイプOHSを使用して(たとえば、システム・コンポーネント値ohs1を使用して)フィールドを設定します。

    OHSサーバー

    リスニング・アドレスとポートか、デフォルトを使用します。

    マシン

    「追加」。これにより、マシンがドメイン(たとえば、ohs1_Machine)に、ノード・マネージャのリスニング値とポート値と一緒に追加されます。ホスト2用の有効な名前またはアドレスなど(ローカル・ホストまたは「すべてのローカル・アドレス」は使用しない)、ホスト1からアクセス可能なホスト2用のリスニング・アドレスを指定する必要があります。

    システム・コンポーネントの割当

    OHSコンポーネント(たとえば、ohs1)。続いて、右矢印を使用して、そのコンポーネントをマシン(たとえば、ohs1_machine)に割り当てます。

    構成サマリー

    「作成」(OPSS手順の実行に数分かかる場合があります)。


4.4.1.3 タスク2: ホスト1でのドメインの圧縮

ホスト1で、次のコマンドを使用してドメインを圧縮します。

<MW_HOME>/ohs/common/bin/pack.sh -domain=path to domain -template=path to template -template_name=name -managed=true

例:

<MW_HOME>/ohs/common/bin/pack.sh -domain=<MW_HOME>/user_projects/domains/ohs1_domain -template=/tmp/ohs1_tmplt.jar -template_name=ohs1 -managed=true

4.4.1.4 タスク3: ホスト2でのドメインの解凍

次の手順を使用して、前述のホスト1で圧縮したドメインをホスト2で解凍します。

  1. 「タスク2: ホスト1でのドメインの圧縮」で作成したテンプレート・ファイルを、ホスト1からホスト2へコピーします。

  2. 次のコマンドを使用してドメインを解凍します。

    <MW_HOME>/ohs/common/bin/unpack.sh -domain=path to domain -template=path to template
    

    例:

    <MW_HOME>/ohs/common/bin/unpack.sh -domain=<MW_HOME>/user_projects/domains/ohs1_domain -template=/tmp/ohs1_tmplt.jar
    

4.4.2 Oracle HTTP Serverのリモート実行

ホスト1で作成したドメインをホスト2で解凍したら、コロケート環境で使用するのと同じ一連のWLSTコマンドとFusion Middleware Controlツールを使用して、コンポーネントの起動、停止、再起動および構成を行えます。

Oracle HTTP Serverをリモート実行するには、次のことを行います。

  1. ホスト1でWebLogic管理サーバーを起動します。

    <MW_HOME>/user_projects/domains/ohs1_domain/bin/startWebLogic.sh &
    
  2. ホスト2でノード・マネージャを起動します。

    <MW_HOME>/user_projects/domains/ohs1_domain/bin/startNodeManager.sh &
    

ホスト1のコロケート実装から、ホスト2のOracle HTTP Serverインスタンスを実行できるようになりました。任意のWLSTコマンドまたはFusion Middleware Controlツールを使用できます。たとえば、ホスト2をノード・マネージャに接続してサーバーohs1を起動するには、ホスト1で次のように入力します。

<MW_HOME>/ohs/common/bin/wlst.sh
nmConnect('weblogic', '<password>', '<nm-host>', '<nm-port>', '<domain-name>', '<domain-directory>','ssl') 
nmStart(serverName='ohs1', serverType='OHS')

Oracle HTTP Serverコンポーネントの起動、停止、再起動および構成の詳細は、4.3項「基本的なOHSタスクの実行」を参照してください。