Oracle BI SE1導入手順
Oracle BI SE1をサーバに導入して運用する上でのポイントについて記載する。
インストールガイド
Oracle BI SE1のインストールにあたっては、Oracleから提供されている以下のインストールガイドに従って行うことで容易にインストールできる。
(1)Oracle business Intelligence Standard Edition Oneのインストール
http://otndnld.oracle.co.jp/pub/articles/bi-se-one/doc/BISE1_Install.pdf
(2)Oracle Business Intelligence Standard Edition Oneインストレーション・ガイドリリース10.1.3.2.1 for Microsoft Windows(E05486-01)
http://otndnld.oracle.co.jp/document/products/bi_se1/10132/generic/E05486-01/toc.htm
必要なリソース
ハードウェア要件
(1)メモリ
2.5GB以上（最小1.5GB）
(2)ディスク
6GB以上の空き領域
(3)ネットワーク
固定IPが割り当てられていること
ソフトウェア（サーバ）
「oc4j」の起動/停止は、バッチによりjavaコマンドを使用して行う形式であり、Windowsサービス化して使用する場合には、以下のようなソフトウェアを各サイトからダウンロードして利用する。各製品のリリースは現時点（2008年5月）のものである。
(1)JavaService
JavaServiceのサイトよりダウンロードする。
http://forge.objectweb.org/projects/javaservice/
JavaService-2.0.10.zip199KB
(2)JavaServiceWrapper
JavaServiceWrapperのサイトよりダウンロードする。
Platform OS(Windows), CPU(x86), 32bit Community(GPLv2版)を使用する。
http://wrapper.tanukisoftware.org/doc/english/download.jsp
wrapper-windows-x86-32-3.3.0.zip335KB
「oc4j」のWindowsサービス化
導入手順としては、Vmware Server上にWindows Server 2003 SEをインストールした環境をベースに記述する。
JavaServiceを使用する場合
(1)JavaServiceのインストール
ダウンロードした「JavaService-2.0.10.zip」ファイルを適当なフォルダに展開する。
(2)サービスのインストール
展開したフォルダ(例：C:\ JavaService-2.0.10)にカレントディレクトリを変更して、JavaService.exeを使用してサービスを登録する。
javaservice.exe -install "Oracle BI SE1" D:\oracle\bise1\jdk\jre\bin\server\jvm.dll -Djava.class.path=D:\oracle\bise1\bi\oc4j_bi\j2ee\home\oc4j.jar -start oracle.oc4j.loader.boot.BootStrap -description "Oracle BI SE1 OC4J Service"※サービスのスタートアップの種類は自動として登録されるため、手動の場合は上記に「-manual」パラメタを追加して登録する。
※起動するクラス名は「oc4j.jar」の中の「MANIFEST.MF」の「Main-Class」で記述されている「oracle.oc4j.loader.boot.BootStrap」となる。
※上記の登録方法では、サービスの停止時はJVMの停止による方法でありアプリケーション実行中は「admin.jar」を使用することが望ましい。（「-stop」での停止時の処理の指定方法が不明なため）
(3)サービスのアンインストール（必要に応じて）
展開したフォルダ(例：C:\ JavaService-2.0.10)のJavaService.exeを使用してサービスを削除する。
javaservice.exe -uninstall "Oracle BI SE1"
(4)「oc4j」のスタートアップ時起動の抑止
「oc4j」はインストールしたユーザのログイン時に自動起動するようになっているため、それを抑止する。
ファイル名を指定して実行から「msconfig」を実行して「システム構成ユーティリティ」の「スタートアップ」タブの「oc4j」のチェックをはずす。
JavaServiceWrapperを使用する場合
(1)JavaServiceWrapperのインストール
ダウンロードした「wrapper-windows-x86-32-3.3.0.zip」ファイルを適当なフォルダに展開する。
Bin, conf, doc, jdoc, lib, logs, srcのサブディレクトリが作成される。
(2)構成ファイルの作成(oc4j.conf)の作成
作成されたフォルダ(例：C:\wrapper-windows-x86-32-3.3.0\conf)に新規に「oc4j.conf」を作成する。（作成例を添付）
「wrapper.conf」を参考にして、WrapperSimpleAppでoc4jの基本的な起動方法「java -jar oc4j.jar」に準じた設定を行う。（停止はSystem.exit()により行われる。）
※起動するクラス名は「oc4j.jar」の中の「MANIFEST.MF」の「Main-Class」で記述されている「oracle.oc4j.loader.boot.BootStrap」となる。
※Library Pathで設定している「D:\oracle\bise1\bi\server\bin」は実行時にエラーが出たため追加したもの。
(3)Install用バッチファイル(Install_oc4j.bat)の作成
展開したフォルダ(例：C:\wrapper-windows-x86-32-3.3.0\bin)にある「InstallTestWrapper-NT.bat」をコピーして「Install_oc4j.bat」を作成する。
構成ファイル名を前項で作成した「oc4j.conf」に変更する。
：
rem
rem Find the wrapper.conf
rem
:conf
set _WRAPPER_CONF="%~f1"
if not %_WRAPPER_CONF%=="" goto startup
set _WRAPPER_CONF="%_REALPATH%..\conf\oc4j.conf"
rem
rem Install the Wrapper as an NT service.
rem
:startup
"%_WRAPPER_EXE%" -i %_WRAPPER_CONF%
if not errorlevel 1 goto :eof
pause(4)実行用バッチファイルの作成（オプション）
展開したフォルダ(例：C:\wrapper-windows-x86-32-3.3.0\bin)の「TestWrapper.bat」をコピーして「oc4j.bat」を作成する。
構成ファイル名を前項で作成した「oc4j.conf」に変更する。
：
rem
rem Find the wrapper.conf
rem
:conf
set _WRAPPER_CONF="%~f1"
if not %_WRAPPER_CONF%=="" goto startup
set _WRAPPER_CONF="%_REALPATH%..\conf\oc4j.conf"
rem
rem Start the Wrapper
rem
:startup
"%_WRAPPER_EXE%" -c %_WRAPPER_CONF%
if not errorlevel 1 goto :eof
pause
Wrapperの起動時パラメタ
-iインストール
-rアンインストール
-cコンソールで実行
(5)「oc4j」のスタートアップ時起動の抑止
「oc4j」はインストールしたユーザのログイン時に自動起動するようになっているため、それを抑止する。
ファイル名を指定して実行から「msconfig」を実行して「システム構成ユーティリティ」の「スタートアップ」タブの「oc4j」のチェックをはずす。
「oc4j.conf」の例
#********************************************************************
# Wrapper License Properties (Ignored by Community Edition)
#********************************************************************
#include ../conf/wrapper-license.conf
#********************************************************************
# Wrapper Java Properties
#********************************************************************
# Java Application
wrapper.java.command=java
oc4j.jarファイルを指定# Java Main class
wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp
# Java Classpath (include wrapper.jar)
wrapper.java.classpath.1=../lib/wrapper.jar
wrapper.java.classpath.2=D:\oracle\bise1\bi\oc4j_bi\j2ee\home\oc4j.jar
# Java Library Path (location of Wrapper.DLL or libwrapper.so)
wrapper.java.library.path.1=../lib
wrapper.java.library.path.2=D:\oracle\bise1\bi\server\bin
実行時にperfjniがライブラリパスになくエラーとなったため追加# Java Additional Parameters
#wrapper.java.additional.1=
# Initial Java Heap Size (in MB)
#wrapper.java.initmemory=3
oc4j.jarのMain-Class
# Maximum Java Heap Size (in MB)
#wrapper.java.maxmemory=64
# Application parameters.Add parameters as needed starting from 1
wrapper.app.parameter.1=oracle.oc4j.loader.boot.BootStrap
#********************************************************************
# Wrapper Logging Properties
#********************************************************************
# Format of output for the console.(See docs for formats)
wrapper.console.format=PM
# Log Level for console output.(See docs for log levels)
wrapper.console.loglevel=INFO
# Log file to use for wrapper output logging.
wrapper.logfile=../logs/wrapper.log
# Format of output for the log file.(See docs for formats)
wrapper.logfile.format=LPTM
# Log Level for log file output.(See docs for log levels)
wrapper.logfile.loglevel=INFO
# Maximum size that the log file will be allowed to grow to before
#the log is rolled. Size is specified in bytes.The default value
#of 0, disables log rolling.May abbreviate with the 'k' (kb) or
#'m' (mb) suffix.For example: 10m = 10 megabytes.
wrapper.logfile.maxsize=0
# Maximum number of rolled log files which will be allowed before old
#files are deleted.The default value of 0 implies no limit.
wrapper.logfile.maxfiles=0
# Log Level for sys/event log output.(See docs for log levels)
wrapper.syslog.loglevel=NONE
コンソール起動時の見出し
#********************************************************************
# Wrapper Windows Properties
#********************************************************************
# Title to use when running as a console
wrapper.console.title=oc4j Wrapper
#********************************************************************
# Wrapper Windows NT/2000/XP Service Properties
#********************************************************************
# WARNING - Do not modify any of these properties when an application
#using this configuration file has been installed as a service.
#Please uninstall the service before modifying this section.The
サービス名、表示、説明を指定#service can then be reinstalled.
# Name of the service
wrapper.ntservice.name=BISE1
# Display name of the service
wrapper.ntservice.displayname=Oracle BI SE1
# Description of the service
wrapper.ntservice.description=Oracle BI SE1
# Service dependencies.Add dependencies as needed starting from 1
wrapper.ntservice.dependency.1=
# Mode in which the service is installed.AUTO_START or DEMAND_START
wrapper.ntservice.starttype=AUTO_START
# Allow the service to interact with the desktop.
wrapper.ntservice.interactive=false
留意点
(1)VMwareの仮想環境で2.5GBを割り当てたが、インストール時のチェックでは2GBと認識され、警告が表示された。（インストールは可能であるが原因は不明）
(2)DHCPの場合は警告が表示され、Oracleのlistener.ora, tnsnames.ora上のホスト指定が、IP表記されていた。（固定IPで導入した時は、ホスト名で表記されていた。）
(3)Windows Server 2008には導入できない。（現時点では、OSのバージョンチェックでエラーとなりインストールできない。）
Oracle Universal Installerを起動中です...
インストーラ要件の確認中...
オペレーティング・システムのバージョンを確認中: 必須 5.0, 5.1 or 5.2 .実際6.0
失敗しました <<<<
(4)リモートからのサービスの起動/停止は、「scコマンド」により操作できる。
起動 sc \\ServerName start “Service Name”
停止 sc \\ServerName stop “Service Name”
状況 sc \\ServerName query “Service Name”
「scコマンド」を実行したときに以下のようなメッセージが表示される場合は、サービス起動権限の確認を行う。（Administratorグループに属しているかなど）
[SC] OpenSCManager FAILED 5
ログイン時と異なるユーザで起動する場合は、事前に当該サーバのリソースを共有しておくことで可能となる。
net use \\ServerName\IPC$ Password /user:ServerName\UserName
(5)Windowsサービスとして登録する時の、クラス名は「MANIFEST.MF」ファイルを参照する。
当該jarファイルをUnzipして内容を確認する。
例：oc4j.jarのMETA-INF/MANIFEST.MF
Manifest-Version: 1.0
Ant-Version: Apache Ant 1.6.5
Created-By: 1.4.2 (Sun Microsystems, Inc.)
Main-Class: oracle.oc4j.loader.boot.BootStrap
Class-Path: lib/pcl.jar
Name: Oracle Application Server Containers for J2EE 10g
Implementation-Title: oracle.oc4j
Implementation-Version: 10.1.3.1.0
Implementation-Vendor: Oracle.
(6)「oc4j」の停止は、アプリケーション実行中は「admin.jar」もしくは「oc4j.cmd」で行うことが望ましい。
参考）スタンドアロン環境でのOC4Jの停止
(7)VM環境では、「Oracle BI Presentation Serer」がシステム起動時にタイムアウト(30秒)で起動できないことがある。
(a)タイムアウト時間を大きくするには、レジストリエディタ(regedit)を使用して以下のレジストリエントリを追加する。（大きな値を指定するとサービス立ち上げのタイムアウト時間が長くなる。）
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control
名前: ServicesPipeTimeout
値の種類 : REG DWOR
データ:60000（ミリ秒）
(b)リモートマシンから起動する場合は、「Oracle BI Presentation Serer」（サービス名：sawsvc）を「scコマンド」を使用して起動する。
「sc コマンド」は表示名ではなくサービス名を指定する。（net start/stopはどちらでもできる）
（サービスが停止している状態）
C:\>sc \\bi-se1 query sawsvc
SERVICE_NAME: sawsvc
TYPE: 10WIN32_OWN_PROCESS
STATE: 1STOPPED
(NOT_STOPPABLE,NOT_PAUSABLE,IGNORES_SHUTDOWN)
WIN32_EXIT_CODE: 0(0x0)
SERVICE_EXIT_CODE: 0(0x0)
CHECKPOINT: 0x0
WAIT_HINT: 0x0
（サービスの開始）
C:\>sc \\bi-se1 start sawsvc
SERVICE_NAME: sawsvc
TYPE: 10WIN32_OWN_PROCESS
STATE: 2START_PENDING
(STOPPABLE,NOT_PAUSABLE,ACCEPTS_SHUTDOWN)
WIN32_EXIT_CODE: 0(0x0)
SERVICE_EXIT_CODE: 0(0x0)
CHECKPOINT: 0x0
WAIT_HINT: 0x2328
PID: 2072
FLAGS:
（サービスが起動している状態）
C:\>sc \\bi-se1 query sawsvc
SERVICE_NAME: sawsvc
TYPE: 10WIN32_OWN_PROCESS
STATE: 4RUNNING
(STOPPABLE,NOT_PAUSABLE,ACCEPTS_SHUTDOWN)
WIN32_EXIT_CODE: 0(0x0)
SERVICE_EXIT_CODE: 0(0x0)
CHECKPOINT: 0x0
WAIT_HINT: 0x0
