プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド
12c (12.2.1.2)
E82763-01
  ドキュメント・ライブラリへ移動
ライブラリ
製品リストへ移動
製品
目次へ移動
目次
索引へ移動
索引

前
 
次
 

5.1 Reports Serverの起動と停止

Reports Serverを実行する最善の方法は、Oracle WebLogic Scripting Tool (WLST)による方法です。ノード・マネージャにより、Oracle HTTP Server、Oracle WebLogic ServerプロセスおよびOracleAS Reports Servicesの初期化、メンテナンスおよび停止を一元化したメカニズムが実現されます。ノード・マネージャによりReports Serverを構成する方法の詳細は、第7.8項「ノード・マネージャのReportsプロセス管理を使用したReports Serverの構成」を参照してください。


重要:

なんらかの理由でReports Serverが応答しなくなった場合、ノード・マネージャは自動的に再起動します。

Oracle Reportsでは、Reports ServerをWindowsサービスとして実行する方法がサポートされなくなりました(rwserver -install server_name)。これにより、関連するコマンドライン・キーワードINSTALLおよびUNINSTALLの使用が廃止されています。

WindowsサービスとしてReports Serverを実行する方法の廃止の詳細は、OTN (Oracle Technology Network)にある『A Guide to Functional Changes Between Oracle Reports 6i and 10g』を参照してください。


5.1.1 スクリプトを使用したノード・マネージャからのReports Serverの起動、停止

Reports Serverを起動および停止するには、次のUNIXコマンドを使用してください。

$DOMAIN_HOME/bin/startComponent.sh reports_server_name

$DOMAIN_HOME/bin/stopComponent.sh reports_server_name

5.1.2 Reports Serverを起動および停止するその他の方法

Reports Serverをノード・マネージャを使用して実行しない場合、以前からある次の方法でReports Serverを実行できます。

  • インプロセス・サーバーの起動(WindowsおよびUNIX)

  • コマンドラインからのReports Serverの起動(WindowsおよびUNIX)

  • Reports Serverの停止


重要:

前述のとおり、Oracle Reports 10gリリース2 (10.1.2)から、WindowsサービスとしてのReports Serverの実行はサポートされなくなりました。

5.1.2.1 インプロセス・サーバーの起動(WindowsおよびUNIX)

Reports Serverをインプロセス・サーバー(デフォルトの構成)として使用している場合、レポート実行リクエストを送信するとインプロセス・サーバーが起動されます。ただし、コマンドラインを介してリクエストを送信する場合、最初にレポート実行URLまたはWebコマンドURLを使用してサーブレットを起動する必要があります。サーブレットの起動に成功した場合は、インプロセス・サーバーの起動も成功したことになります。

URLからインプロセス・サーバーを直接起動するには、Webブラウザで次のように入力します。

http://your_machine_name:your_port_num/reports/rwservlet/startserver

5.1.2.2 コマンドラインからのReports Serverの起動(WindowsおよびLinux)

Reports Serverをコマンドラインから起動する際は、事前にCOMPONENT_CONFIG_PATH環境変数を次のように設定しておく必要があります。

COMPONENT_CONFIG_PATH=${DOMAIN_HOME}/config/fmwconfig/components/ReportsServerComponent/<reports_server_name>

WindowsでReports Serverをスタンドアロン・サーバーとして起動するには、次のコマンドを使用します。

rwserver server=server_name

サーバーを起動する際に、ダイアログ・ボックスやメッセージを表示しない場合は、コマンドライン・キーワードBATCHを追加します。

rwserver server=server_name batch=yes

UNIXでは、次の構文を使用してこのコマンドを実行できます。

rwserver.sh server=server_name

または

rwserver.sh server=server_name batch=yes

注意:

コマンドラインからReports Serverを起動する前に、Reports Serverがまだ存在しない場合は作成してください。Reports Serverの作成の詳細は、第7.8.4項「新規Reports Serverコンポーネント・タイプの作成」を参照してください。


重要:

DISPLAYが設定されていない場合、Reports Serverをバッチ・モード(batch=yes)で起動する必要があります。

UNIXにおいてDISPLAYおよびプリンタ依存性を解消する方法の詳細は、第10.8項を参照してください。

REPORTS_DEFAULT_DISPLAY環境変数の詳細は、付録Bを参照してください。


シェル・スクリプトがPATH環境変数でアクセスできれば、このコマンドは任意のディレクトリから実行できます。

5.1.2.3 Reports Serverの停止

WindowsおよびUNIXでReports Serverを停止するには、次のようにいくつかの方法があります。

  • Windowsでrwserver実行可能ファイルを使用してReports Serverを実行している場合や、UNIXでシェル・スクリプトのrwserver.shを使用してReports Serverを実行している場合は、「Reports Server」ダイアログ・ボックスの「停止」をクリックします。

  • Reports Servletを介してReports Serverをインプロセス・サーバーとして実行している場合は、次のURLを発行します。

    http://your_host_name:port_number/reports/rwservlet/stopserver?authid=admin_user/admin_password
    
  • WindowsまたはUNIXでReports Serverをコマンドラインから実行している場合は、Reports Serverの停止方法に応じて、次のいずれかのコマンドを使用します。


    注意:

    UNIXでは、rwserverのかわりにrwserver.shを使用します。

    サーバーを停止する際は、COMPONENT_CONFIG_PATH環境変数を次のように設定しておく必要があります。

    COMPONENT_CONFIG_PATH=${DOMAIN_HOME}/config/fmwconfig/components/ReportsServerComponent/<reports_server_name>

    サーバーを正常に停止(保留中のジョブを終了してから停止)するには、次のコマンドを実行します。

    rwserver server=server shutdown=normal authid=username/password
    

    サーバーをただちに停止(保留中のジョブを終了せずに停止)するには、次のコマンドを実行します。

    rwserver server=server shutdown=immediate authid=username/password
    

    関連メッセージを表示せずにサーバーを停止するには、次のコマンドを実行します。

    rwserver server=server shutdown=normal authid=username/password batch=yes
    

    rwserverコマンドで使用されるキーワードの詳細は、付録A「コマンドライン・キーワード」を参照してください。


    注意:

    authidは、Reports Serverの管理ユーザー名およびパスワードです。Oracle Reports 12c (12.2.1.2)のデフォルトのセキュリティでは、Oracle Platform Security Servicesによる標準ベースのJava EEセキュリティ・モデルを基盤としています。セキュアでないReports Serverの場合、このユーザーは、identifier要素内で定義されます。セキュアでないReports Serverをコマンドラインから停止する方法を、次で説明します。

  • rwserver.shまたはrwrqv.shを使用してセキュアでないReports Serverをコマンド・ラインから停止またはシャットダウンする場合は、有効なAUTHIDを指定する必要があり、この値はサーバー構成ファイルのidentifier要素に設定された値と一致している必要があります。ただし、identifier要素は、Oracle Application Serverのインストール時、Reportsを構成する際に設定され、Reports Serverによって暗号化されています。このidentifier要素は任意の値に変更できます。'identifier'を変更するには、次の手順を実行します。

    1. セキュアでないReports Serverのserver_name.conf構成ファイルで、identifier要素を変更してusername/passwordを指定し、encrypted属性をnoに設定します。例:

      <identifier encrypted="no">scott/tiger</identifier>
      
    2. Reports Serverを手動でいったん停止してから再起動し、server_name.confファイルに行った変更を有効にします。


      注意:

      構成の変更を有効にするには、Reports Serverを再起動する必要があります。

      これで、Reports Serverで、identifier要素のusername/password値が暗号化されます。Reports Serverでserver_name.confファイルの変更内容が読み取られると、次のコマンドが正常に実行されます(username/passwordがscott/tigerであることが前提)。

      ./rwserver.sh server=server_name shutdown=normal authid=scott/tiger
      ./rwrqv.sh server=server_name shutdown=normal authid=scott/tiger