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

前
 
次
 

7.8 ノード・マネージャのReportsプロセス管理を使用したReports Serverの構成

Reports Serverの起動、停止、監視および管理を行う方法としては、Oracle Process Manager and Notification Server (OPMN)およびOracle Enterprise Managerの使用をお薦めします。

Oracle Fusion Middlewareコンポーネント(Reports Serverなど)の初期化、維持および停止を一元化したメカニズムをOPMNにより実現します。Oracle Reportsコンポーネントの障害検出とリカバリはデフォルトでOPMNによって管理されており、Oracle Reports 12cリリース(12.2.1.1)のヘルス・チェック・メカニズムが強化されています。

プロセスがなんらかの理由で失敗すると、Nodemanagerが自動的にReports Serverを再起動します。

Oracle Fusion Middlewareをインストールする際、Reports Serverは自動的にノード・マネージャで構成されます。

7.8.1 コンポーネントの起動と停止

コンポーネントの起動 / 停止はWLSTコマンドを使用して実行されます。ノード・マネージャで動作するReportsプロセス管理プラグインが、Reports Server / Bridgeの実際のプロセス管理を実行します。Reportsプロセスが停止すると、ノード・マネージャがそれを検知してプロセスを再起動します。

これらの例の説明は、次のとおりです。

  • Reports Serverコンポーネントの名前 - repsvr1

  • Reports Bridgeコンポーネントの名前 - repbrd1

  • ドメイン・ホーム - /scratch/rrpai/wls2/user_projects/domains/test1

7.8.1.1 FMWスクリプト

次のコマンドを使用します。

$DOMAIN_HOME/bin/startComponent.sh  repsvr1
$DOMAIN_HOME/bin/stopComponent.sh  repsvr1
 
$DOMAIN_HOME/bin/startComponent.sh  repbrd1
$DOMAIN_HOME/bin/stopComponent.sh  repbrd1

7.8.1.2 WLST 起動 / 停止

WLSTオンライン

setenv ORACLE_HOME  /scratch/rrpai/wls2
 
$ORACLE_HOME/oracle_common/common/bin/wlst.sh
connect("weblogic","welcome1", "localhost:7001")
domainRuntime()
# reports server
cd('/SystemComponentLifeCycleRuntimes/repsvr1')
# start reports server
cmo.start(java.util.Properties())
# get state of reports server
cmo.getState()
# stop reports server
cmo.shutdown(java.util.Properties())
 
# reports bridge
cd('/SystemComponentLifeCycleRuntimes/repbrd1')
# start reports bridge
cmo.start(java.util.Properties())
# get state of reports bridge
cmo.getState()
# stop reports bridge
cmo.shutdown(java.util.Properties())

WLSTオフライン

$ORACLE_HOME/oracle_common/common/bin/wlst.sh
# nmConnect('weblogic', 'welcome1', 'localhost', 'NodeManagerPort', 'DomainName', 'DomainHome')
nmConnect('weblogic', 'welcome1', 'localhost', '5556', 'test1', '/scratch/rrpai/wls2/user_projects/domains/test1')
# reports server
nmStart(serverName='repsvr1', serverType='ReportsServerComponent')
nmKill(serverName='repsvr1', serverType='ReportsServerComponent')
 
# reports bridge
nmStart(serverName='repbrd1', serverType='ReportsBridgeComponent')
nmKill(serverName='repbrd1', serverType='ReportsBridgeComponent')

7.8.1.3 プロセス制御と関連付けられたファイル

repsvr1はReports Serverの名前です

ReportsBridgeComponentはReports Bridgeの場所です

起動プロパティはnodemanagerにより管理されます

$DOMAIN_HOME/system_components/ReportsServerComponent/repsvr1/data/nodemanager/startup.properties

次に、nodemanagerのプロパティの一部を示します。

表7-33 nodemanagerのプロパティ

プロパティ 説明

RestartMax

ノード・マネージャがサーバーの再起動を試行できる回数。

2

RestartInterval

ノード・マネージャが、障害の発生したサーバーの再起動を試行し続ける期間。この期間中、ノード・マネージャはRestartMaxで定義された回数まで、障害の発生したサーバーを再起動しようとします。デフォルトでは、ノード・マネージャはFAILED_NOT_RESTARTABLE状態に到達するまで、無期限にサーバーの再起動を試行します。

3600

RestartDelaySeconds

ノード・マネージャがサーバーの再起動を試行するまでに待機する秒数。

0

AutoRestart

このサーバーで障害が発生した場合に、ノード・マネージャが自動的にそれを再起動できるかどうかを指定します。

true


  • Reportsの環境およびタイムアウト構成

    $DOMAIN_HOME/system_components/ReportsServerComponent/repsvr1/data/nodemanager/reports_process.xml

  • nodemanagerログ

    $DOMAIN_HOME/nodemanager/nodemanager.log

  • Reports Serverのstdoutログ、NodeManagerにより作成

    $DOMAIN_HOME/servers/repsvr1/logs/repsvr1.out

  • nodemanagerプロセス制御ログ構成

    $DOMAIN_HOME/nodemanager/nodemanager.properties

  • ログ・レベルの変更は次の設定を変更

    LogLevel=INFO

7.8.1.4 Reportsプロセス管理構成ファイル

例: $DOMAIN_HOME/system_components/ReportsServerComponent/repsvr1/data/nodemanager/reports_process.xml

次の項目を設定できます。

  • サーバーに設定する環境変数

    • appendを'true'に設定すると、プラットフォーム固有のパス・セパレータ(Windowsでは';'およびUnixでは':')を使用して現在の値に値が追加されます。これはPATHのような環境変数に適しています。

    • appendを'false'に設定すると、環境変数の値が置き換えられます

  • 停止のタイムアウト

  • これは、Reports Serverの停止時におけるnodemanagerのReportsプラグインの動作です

    • 最初に'normal'モードで停止を試行します。つまり、Reports Serverで実行中のReportsジョブの終了を待機します

    • 構成に指定された'timeout'中に停止しない場合、即時モードでの停止試行を送信します(つまり、ジョブの終了を待機しません)

    • 'timeout'中に再度停止しない場合、プロセスを強制停止します

<?xml version = '1.0' encoding = 'UTF-8'?>
<process xmlns="http://xmlns.oracle.com/reports/process" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <environment>
    <variable id="PATH" value="/scratch/oracle/testPath" append="true"/>
    <variable id="MY_PATH" value="/home/oracle/myPath" append="false"/>
    <variable id="MY_ENV" value="my_env_value"/>
  </environment>
  <stop timeout="30"/>
</process>

7.8.2 新規Reports Toolsコンポーネント・タイプの作成

次のコマンドを使用します。

$MW_HOME/oracle_common/common/bin/wlst.sh
connect("weblogic","welcome1", "localhost:7001")
help()
help('reports_tools')
help('createReportsToolsInstance')
help('deleteReportsToolsInstance')
createReportsToolsInstance(instanceName='reptools1', machine='M1')
deleteReportsToolsInstance(instanceName='reptools1')
exit()

7.8.3 新規Reports Bridgeコンポーネント・タイプの作成

次のコマンドを使用します。

$MW_HOME/oracle_common/common/bin/wlst.sh
connect("weblogic","welcome1", "localhost:7001")
help()
help('reports_bridge')
help('createReportsBridgeInstance')
help('deleteReportsBridgeInstance')
createReportsBridgeInstance(instanceName='repbridge1', machine='M1')
deleteReportsBridgeInstance(instanceName='repbridge1')
exit()

7.8.4 新規Reports Serverコンポーネント・タイプの作成

次のコマンドを使用します。

$MW_HOME/oracle_common/common/bin/wlst.sh 
connect("weblogic","welcome1", "localhost:7001")
help()
help('reports_server')
help('createReportsServerInstance')
help('deleteReportsServerInstance')
createReportsServerInstance(instanceName='repsvr1', machine='M1')
deleteReportsServerInstance(instanceName='repsvr1')
exit()