Oracle® Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド 12c (12.2.1.3.0) E90222-01 |
|
前 |
次 |
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.3)のヘルス・チェック・メカニズムが強化されています。
プロセスがなんらかの理由で失敗すると、Nodemanagerが自動的にReports Serverを再起動します。
Oracle Fusion Middlewareをインストールする際、Reports Serverは自動的にノード・マネージャで構成されます。
コンポーネントの起動 / 停止はWLSTコマンドを使用して実行されます。ノード・マネージャで動作するReportsプロセス管理プラグインが、Reports Server / Bridgeの実際のプロセス管理を実行します。Reportsプロセスが停止すると、ノード・マネージャがそれを検知してプロセスを再起動します。
これらの例の説明は、次のとおりです。
Reports Serverコンポーネントの名前 - repsvr1
Reports Bridgeコンポーネントの名前 - repbrd1
ドメイン・ホーム - /scratch/rrpai/wls2/user_projects/domains/test1
次のコマンドを使用します。
$DOMAIN_HOME/bin/startComponent.sh repsvr1 $DOMAIN_HOME/bin/stopComponent.sh repsvr1 $DOMAIN_HOME/bin/startComponent.sh repbrd1 $DOMAIN_HOME/bin/stopComponent.sh repbrd1
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')
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で定義された回数まで、障害の発生したサーバーを再起動しようとします。デフォルトでは、ノード・マネージャは |
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
例: $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>
次のコマンドを使用します。
$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()
次のコマンドを使用します。
$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()
次のコマンドを使用します。
$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()