この章では、前のリリースのEDQから11g (11.1.1.7)リリースにアップグレードする方法について、次の内容で説明します。
この製品にはJavaアーカイブ(JAR)ファイルが付属しており(tools
ディレクトリ)、これを使用して、この章で説明するEDQのアップグレードを行います。
この項の説明に従って、サーバー上のEDQのアップグレードを準備します。
EDQリリース11g R1 (11.1.1.7)には完全にリファクタリングされた結果表が保持されているため、前回の結果(前のバージョンのEDQからのアップグレード)を持つジョブ内のすべてのプロセス・タスクについては、インテリジェント実行をオフにして実行し、新しい結果表が適切な形式で生成されるようにする必要があります。インテリジェント実行をオンにして実行したプロセス・タスクでは、エラーが生成されます。これは、前のバージョンから生成された結果を持たないプロセスには影響を与えません。
EDQリリース11g R1 (11.1.1.7)へのアップグレード後には、既存の結果を(アップグレード済のEDQ結果データベースに)持つすべてのジョブが、すべてのプロセス・タスクでインテリジェント実行がオフの状態で実行されるようにし、新しい結果表が生成されるようにします。
結果表がすでに存在する場合、インテリジェント実行をオンにして実行したプロセス・タスクでは、エラーが生成されます。
次の情報を収集して書き留めてください。
現在のEDQ構成ディレクトリの場所(EDQ Launchpadで表示できます)。
既存のconfig
ディレクトリの場所は、デプロイされたアプリケーションのWEB-INF
ディレクトリ内のconfigdir.txt
ファイルに記述されています。このディレクトリ内のカスタム構成は、EDQ 11gをサポートする新しいディレクトリに後でコピーされます。
EDQリポジトリ・データベース・スキーマへの接続の詳細(DIRECTOR
およびRESULTS
)。これらのスキーマは、EDQリリース11g R1 (11.1.1.7)をサポートするようにアップグレードされます。
注意: この項は、ケース管理を使用する場合にのみ当てはまります。 |
リリース11g R1 (11.1.1.7)より前のリリースからEDQをアップグレードする場合は、移行前スクリプトを実行して、アップグレードによってケース管理データが適切に移行されるようにします。移行前スクリプトは、EDQ OUIインストーラでインストールされるEDQディストリビューションの一部であり、migration.jar
ファイルにパッケージ化され、これを使用して実行されます。移行上の問題が存在する場合は、それを修正できるように、問題の詳細を説明するレポートが生成されます。
使用するシステムでEDQをアップグレードするには、次の手順を実行します。
第4章「EDQインストーラの実行」の説明に従って、EDQ OUIインストーラを実行して、システムにmigration.jar
をインストールします。
次のコマンドを実行して移行前レポートを実行します(db_connection
には、ディレクタ・データベース・スキーマへの接続方法を指定します)。
java -jar migration.jar premigrate
db_connection
たとえば、データベース接続は次のようになります。
dbtyp
:dbid
@host
:port
/user
/password
次に、前の例の構文を説明します。
dbtype
: PostgreSQLデータベースの場合はpgsql
を、Oracle Databaseの場合はorcl
を設定します。
dbid
: PostgreSQLデータベースの場合はデータベース名を、Oracle Databaseの場合はSIDを設定します。
host
: RDBMSホスト・マシンの名前を設定します。
port
: オプション。値を指定しない場合は、そのデータベース・タイプのデフォルトのポートが前提となります。デフォルト以外のポート番号でデータベースを実行する場合、データベース・ポート番号の値を指定する必要があります。
user
: EDQがディレクタ・データベースへの接続に使用するユーザーIDを設定します。
password
: データベース・ユーザーのパスワードを設定します(パスワードを指定しない場合はそのユーザー名がデフォルトとなります)。
移行前レポートを確認します。移行前レポートからの出力になんらかの問題が記載されている場合は、更新に進む前に対処する必要があります。
以降の項では、EDQとWebLogic Serverの環境のアップグレードについて説明します。
リポジトリ・データベースをアップグレードするには、次の手順を実行します。
WebLogic Serverを停止します。
次のコマンドを実行してディレクタ・データベース・スキーマをアップグレードします(db_connection
には、ディレクタ・データベース・スキーマへの接続方法を指定します)。
java -jar migration.jar migrate
db_connection
データベース接続(db_connection
)の構文については、第7.1項「アップグレードの準備」を参照してください。
たとえば、SIDがorcl
およびユーザー名がdirector
でローカルにデプロイされたOracle DatabaseのOracleインスタンスをアップグレードする場合、コマンドは次のようになります(password
には、director
ユーザーのパスワードを指定します)。
java -jar migration.jar migrate oracle:orcl@localhost:1521/director
/
password
注意: RCUは、EDQスキーマの作成には使用しないでください。 |
PATH
変数には、JDK/JRE実行可能ファイルの場所が含まれています。
migration.jar
を含むディレクトリにナビゲートします。
次のコマンドを実行します(db_connection
は、ディレクタ・データベースへの接続方法を指定します)。
java -jar migration.jar cm -db db_connection
たとえば、データベース接続は次のようになります。
dbtyp
:dbid
@
host
:port
/
user
/
password
データベース接続(db_connection
)の構文については、第7.1項「アップグレードの準備」を参照してください。
構成ディレクトリをアップグレードするには、次の手順を実行します。
EDQ構成アプリケーションを実行して(第5.2項「EDQの構成」を参照)、EDQリリース11g R1 (11.1.1.7)に必要な2つの新しい構成ディレクトリ(edq.home
およびedq.local.home
)を作成します。
既存の(アップグレード前の) EDQ config
ディレクトリの内容を、次のものを除いて、新しいedq.local.home
ディレクトリにコピーします。
logs
サブディレクトリdirector.properties
ファイル既存のdirector.properties
ファイルからのオーバーライド設定を、新しいリリース・ファイルにコピーし、新しいファイルにデータベース接続設定を保持するようにします。
次の手順を実行して、既存のデプロイメントを削除し、EDQリリース11g R1 (11.1.1.7)をデプロイします。
前のアプリケーション・デプロイメントを削除します。
Tomcatの場合: 既存のEDQ WARファイルと、Tomcat webapps
ディレクトリ内の同名の展開済ディレクトリを削除します。
WebSphereの場合: WebSphere管理コンソールを使用するEDQをアンデプロイします。
EDQを新しい構成ディレクトリにリンクするには、edq.config.path
という新しいJavaプロパティを使用して、第5.2項「EDQの構成」で作成した新しいディレクトリへのパスを指定します(たとえば、edq.home
およびedq.local.home
)。このパスは、LinuxおよびUNIXの場合はコロンで区切り、Windowsの場合はセミコロンで区切る必要があります。
また、環境変数を使用してEDQを構成ディレクトリにリンクすることもできます。それには、EDQ_CONFIG_PATH
という環境変数をJAVA_OPTS
環境変数に追加しますが、その際に次のようにPath_to_config_directory1
およびPath_to_config_directory2
を「EDQの構成」の部で作成した新しいディレクトリへのパスで置き換えます。
オペレーティング・システム | Tomcat | WebSphere |
---|---|---|
LinuxおよびUNIX |
EDQサーバーのJavaオプションを次のように設定します。 Dedq.config.path=[Path_to_config_directory1]:[Path_to_config_directory2] -Doracle.mds.cache=simple |
EDQサーバーのJavaオプションを次のように設定します。 Dedq.config.path=[Path_to_config_directory1]:[Path_to_config_directory2] -Doracle.mds.cache=simple |
Windows |
または EDQアプリケーション・サービスのJavaオプションを、次のように設定します。
Javaパラメータの設定の詳細は、次に示すApache TomcatのドキュメントWebサイトを参照してください。 |
EDQサーバーのJavaオプションを次のように設定します。 Dedq.config.path=[Path_to_config_directory1];[Path_to_config_directory2] -Doracle.mds.cache=simple 一般的なJVMパラメータの詳細は、次に示すIBM社のWebSphereのドキュメントWebサイトを参照してください。
|
ADFライブラリをデプロイします(第2.2.5.2項「Tomcatの構成」または第2.2.5.3項「WebSphereの構成」の手順を使用)。
edq.war
ファイルをデプロイします。
Tomcatの場合: WARファイルをTomcat webapps
ディレクトリにコピーします。
WebSphereの場合: WebSphere管理コンソールを使用してEDQアプリケーションをデプロイします。
アプリケーション・サーバーを起動します。