| Oracle® Real User Experience Insightインストレーション・ガイド 12c リリース3 (12.1.0.4) for Linux x86-64 E49734-01 |
|
 前 |
 次 |
| Oracle® Real User Experience Insightインストレーション・ガイド 12c リリース3 (12.1.0.4) for Linux x86-64 E49734-01 |
|
前 |
次 |
この章では、既存のRUEI 11.1または12.1.0.xインストールをリリース12.1.0.4にアップグレードする手順について説明します。インストール後の構成手順については、第5章「RUEIの構成」で説明しています。
追加のインストールの依存性
バージョン12.1.0.3の時点で、新しい依存性が紹介されています。これには、第3.9項「RUEI 11.1から12.1.0.4へのアップグレード」および第3.11項「RUEI 12.1.0.xから12.1.0.4へのアップグレード」で説明しているアップグレード手順の一部として、php-soapモジュール(Linux DVDで入手可能)のインストールが必要です。
アップグレードまたはロールバックの問題のトラブルシューティング
アップグレードおよびロールバック・スクリプトは、/tmp/ruei-upgrade-x.logおよび/tmp/ruei-rollback-x.logファイルにアクションを記録します。アップグレードまたはロールバック中に問題が発生した場合は、該当するファイルをOracleサポート・サービスへのリクエストに添付してください。
RUEI 12.1.0.4の表にデータを表示する方法の主な変更点のサマリーを、次に示します。
親レベル値が現在の値の前に付けられることはなくなりました。
以前のバージョンのRUEIでは、たとえばページ名には接頭辞にアプリケーションおよびページ・グループ値を付けて"MyApp " Admin " Login.asp"になるようにすることで、親値の前に値を付けるのが規則でした。現在は異なり、RUEI 12.1.0.4ではページ名は単純に"Login.asp"として表示されます。
RUEIでは現在、データの階層表示を有効にできるため、UIでの表示中に親レベル値の前に各子値を視覚的に付けることができます。これは視覚的なツールにすぎず、表にデータを格納する方法には関係しません。
空の値を表すにはNULLを使用します。
以前は、RUEIは情報が見つからない値を表示するために特殊値を使用していました。たとえば、特定のセッションに対してユーザーを識別できなかった場合、ユーザーは"anonymous"に設定されます。同様に、ページは"none"、欠落しているcookieは"no-cookie"に設定される可能性があります。
このリリースでは、空の値はすべてNULLに設定されるため、特殊値は不要になりました。KPI、レポート、ダッシュボードでのフィルタなど、既存の構成での特殊値への参照はすべて、インストール中のアップグレード手順によって、NULLを使用するように自動的に変換されます。すべての履歴データを変換するように選択した場合は、データ内の特殊値もすべて更新されます。
page-groupディメンションはNULLにすることができます。
以前のバージョンのRUEIでは、値が見つからなかったページ-グループには、ページ名と同じ値が割り当てられていました。現在は異なります。現在、値を持たないpage-groupはNULLになります。アップグレード手順では、このような状態が自動的に変換されます。
第3.1項「RUEI 12.1.0.4でのデータ表現の変更」で説明している変更は、BIエクスポート内のすべてのRUEI表に適用できます。つまり、RUEI 12.1.0.4にアップグレードした後、BIエクスポート表内のデータが異なった方法で表示されます。
新しいデータ表現が、RUEI BIエクスポート・ユーティリティを使用するアプリケーションと互換性がないことを確認してください。
12.1.0.0.1以前のバージョンで、KPIパーセント値が0および100の間ではなく0および1の間の数値として誤って報告される場合があります。アップグレード・スクリプトは、疑わしいKPI履歴値およびターゲットの修正の確認を要求します。これは、第3.9.1項「レポータ・システムのアップグレード」で説明されています。
履歴データおよびターゲット値が必要に応じて正しく変換されていることを確認する最善の努力を行う一方で、要件を満たすKPIレポートおよびターゲット構成を確認することをお薦めします。
リリース11.1では、XPathクエリーのサポートが拡張され、コンテンツ・スキャニング用の完全なXPath 1.0機能が提供されるようになりました。これは既存のRUEIインストールをアップグレードする際に大きな影響があります。
アップグレード・スクリプトは、現在の構成で検出されたすべてのネームスペースを報告します。アップグレード・プロセス完了時にこれらを明示的に定義する必要があります。定義しなかった場合は、構成が正しく機能しません。
さらに、形式が正しくないXHTMLコードに対して実行されたXPath式は、前のバージョンとは異なる結果を返すことがある点にも注意してください。したがって、RUEIインストールで使用されるすべてのXPath式を慎重に確認することを強くお薦めします。XPathサポートに関する詳細は、『Oracle Real User Experience Insightユーザーズ・ガイド』を参照してください。
バージョン12.1.0.1の時点で、データ・ブラウザ・グループ内の毎時間情報の追加によって、必要なデータベース領域の量が大幅に増加しました。レポート要件を満たしていることを確認するため、データベース使用状況およびデータ保存ポリシーを定期的に確認することをお薦めします。
バージョン12.1.0.3の時点で、新しいインストール内のUSERSおよびUXCONF表領域がデフォルトでforce loggingモードに設定されます。このモードは、オンライン・データベース・バックアップの作成に必要です。以前のデフォルト・モードはnologgingでした。この構成を変更する手順は、Oracle Real User Experience Insightアドバンスト管理者ガイドで説明されています。
既存のユーザーは、force loggingモードを使用せずに作成されたデータベース・バックアップは使用できない可能性があることに注意する必要があります。アップグレード手順は、データベースの現在の設定を変更しません。ただし、force loggingへの表領域モードの変更によってディスクI/Oが大幅に増加する可能性があることに注意してください。
アプリケーション名が、かっこで囲まれたスイート名を含むサブアプリケーションの場合、またはページ-グループ値が、複数のページ名を含むグループではなく実際のページ名である場合、KPI、レポート、ダッシュボード、ユーザー・フローおよびログアウト・イベントのapplication.nameおよびapplication.page-groupフィルタのアップグレードは正しく機能しません。
アップグレード後に機能しない可能性があるアイテムを確認するには、アップグレード・スクリプトからupgrade_checkステップを実行します。
cd /root/RUEI/extra chmod +x ruei-upgrade-12.1.0.4.sh ./ruei-upgrade-12.1.0.4.sh upgrade_check
以前のリリース・バージョンからのフレームワーク例外ダウンロードzipファイルは、12.1.0.4と互換性がありません。アップグレードが完了したら、zipファイルを再びダウンロードして12.1.0.4と互換性のあるバージョンを入手します。
バージョン12.1.0.4の時点で、表2-2で説明しているRUEI_HOME、RUEI_DATA、RUEI_USERおよびRUEI_GROUP設定は、リテラル値の観点から指定する必要があります。したがって、次は許可されません。
RUEI_BASE=/my/ruei/dir
export RUEI_HOME=$RUEI_BASE/home
さらに、表2-2で説明しているTZ設定は、適切なタイム・ゾーン文字列('Europe/Amsterdam'など)に設定する必要があります。適切なタイム・ゾーンを選択するには、tzselectプログラムを実行します。ORA_SDTZ (セッションのデフォルト・タイム・ゾーン)変数を、$TZと同じになるように設定する必要もあります。次に例を示します。
export TZ=Europe/Amsterdam export ORA_SDTZ=$TZ
この項では、既存のRUEI 11.1インストールをリリース12.1.0.4にアップグレードするための手順について説明します。
|
重要: アップグレードを続行する前に、各プロセッサで個別に構成、メイン・データベースおよびデータベースをバックアップします。「システム」、「メンテナンス」の順に選択し、「バックアップおよびリストア」をクリックします。ロールバックの場合には、構成のバックアップが必要です。データベースをバックアップする手順については、『Oracle Enterprise Manager Cloud Control管理者ガイド』を参照してください。 |
この項で説明するレポータのアップグレード手順は、専用のレポータ・システムばかりでなく、単一サーバーのインストールにも適用できます。
次を実行します。
レポータにrootとしてログインします。/rootディレクトリ内でRUEI zipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。
cd /root
unzip Vxxxx.zip
次のコマンドを発行します。
cd /usr/java tar xzf /root/RUEI/Java/jre-7u25-linux-x64.tar.gz
Javaの使用許諾契約に同意するように要求されます。同意しなければ、先に進めません。
これにより、必要なJavaソフトウェアが/usr/java/jre1.7.0_25ディレクトリにインストールされます。インストール・ディレクトリをバージョンに依存しないものにするためには、次のコマンドを使用して、より一般的なsymlinkを作成します。
rm ./jre ln -s /usr/java/jre1.7.0_25 /usr/java/jre
次のコマンドを発行して、php-soapモジュールをインストールします。
rpm -Uhv php-soap-5.1.6-*.x86_64.rpm
次のコマンドを使用して、レポータ・システムおよびコレクタ・システム上のすべての処理を停止します。
cd /root/RUEI/extra chmod +x ruei-upgrade-12.1.0.4.sh ./ruei-upgrade-12.1.0.4.sh stop_ruei
/etc/ruei.confファイルに追加の行を挿入します。
export RUEI_DB_TNSNAME_CFG=$RUEI_DB_TNSNAME
さらに、表2-2で説明しているTZ設定は、適切なタイム・ゾーン文字列('Europe/Amsterdam'など)に設定する必要があります。適切なタイム・ゾーンを選択するには、tzselectプログラムを実行します。ORA_SDTZ (セッションのデフォルト・タイム・ゾーン)変数を、$TZと同じになるように設定する必要もあります。次に例を示します。
export TZ=Europe/Amsterdam export ORA_SDTZ=$TZ
次のコマンドを実行して、アップグレード前に必要なアクションを実行します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh rpm_pre_install
デプロイメントによっては、アップグレード・アクションの完了に数時間かかる場合があります。
ruei-prepare-db.shスクリプトを、データベースがあるシステム上のOracleユーザーに提供します(たとえば、RUEIディストリビューションzipを抽出するなど)。次のコマンドを発行して、RUEIデータベース・インスタンスを更新します。
cd /root/RUEI/121 cp ruei-prepare-db.sh /home/oracle cp -r sql_scripts /home/oracle chmod +x /home/oracle/ruei-*.sh chmod +r /home/oracle/sql_scripts/* su - oracle export ORACLE_HOME=/u01/app/oracle/product/11.2.0/dbhome_1Foot 1 ./ruei-prepare-db.sh sql_packages ./ruei-prepare-db.sh user_grants ./ruei-prepare-db.sh set_incremental_stats
完了すると、再びrootユーザーになります。
必要なコレクタ・システムごとに、第3.9.2項「リモート・コレクタ・システムのアップグレード」で示されている手順を実行します。完了したら、手順10に進みます。
次のコマンドを使用して、新しいリリースのRPMをインストールします。
cd /root/RUEI/121 chmod +x ruei-install.sh ./ruei-install.sh reporter
既存のインストール(アップグレード)では、次のコマンドを使用してRPMをインストールした後にフォントをコピーする必要があります。
cp RUEI_HOME/bi-publisher/fonts/* /usr/java/jre/lib/fonts/
rootユーザーとして、RUEI_USERユーザーの.bash_profileファイル(RUEI_DATA/.bash_profile)に次の行を追加します。
source /etc/ruei.conf
source RUEI_HOME/bin/env.sh
次のコマンドを実行して、アップグレード後に必要なアクションを実行します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh rpm_post_install
第3.2項「KPI値」で説明されているように、アップグレード・スクリプトにより疑わしい履歴値およびターゲットの変換の確認を要求される場合があります。
上で行った選択を変更する場合、次のコマンドを実行して、この手順を再実行できます。
./ruei-upgrade-12.1.0.4.sh kpi_convert_percent
手順11を開始する前に、上のコマンドを実行する必要があります。
次のコマンドを使用して、処理を再起動します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh reinitialize ./ruei-upgrade-12.1.0.4.sh start_ruei
アップグレードでは、RUEI構成および現在のデータが新しいモデルに変換されます。ただし、古いデータはまだ変換されていません。詳細は、第3.9.3項「履歴データのアップグレード」を参照してください。
|
注意: アップグレード中またはその後で、イベント・ログ( 「システム」、「ステータス」、「イベント・ログ」の順に選択)にエラーまたは情報メッセージが出現したら、アップグレード手順の完了後に既読としてマークし、新しいメッセージが報告されているかどうかを監視。エラー・メッセージが再び生じた場合、Oracleサポート・サービスにご連絡ください。 |
必要なコレクタ・システムごとに、rootとしてログインします。/rootディレクトリ内でRUEI zipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動して、新しいリリースのPRMをインストールします。次を実行します。
次のコマンドを使用して、RUEIディストリビューション・パッケージを解凍します。
cd /root
unzip Vxxxx.zip
次のコマンドを発行します。
cd /usr/java tar xzf /root/RUEI/Java/jre-7u25-linux-x64.tar.gz
Javaの使用許諾契約に同意するように要求されます。同意しなければ、先に進めません。
これにより、必要なJavaソフトウェアが/usr/java/jre1.7.0_09ディレクトリにインストールされます。インストール・ディレクトリをバージョンに依存しないものにするためには、次のコマンドを使用して、より一般的なsymlinkを作成します。
rm ./jre ln -s /usr/java/jre1.7.0_25 /usr/java/jre
次のコマンドを使用して、コレクタRPMをアップグレードします。
cd /root/RUEI/121 chmod +x ruei-install.sh ./ruei-install.sh collector
rootユーザーとして、RUEI_USERユーザーの.bash_profileファイル(RUEI_DATA/.bash_profile)に次の行を追加します。
source /etc/ruei.conf
source RUEI_HOME/bin/env.sh
必要なコレクタ・システムごとに上の手順を完了した後、レポータ・システムのアップグレードを続行する必要があります(第3.9.1項「レポータ・システムのアップグレード」を参照)。
RUEI 12.1.0.4ではデータの格納および問合せに新しいデータ・モデルを使用するため、12.1.0.4以前のデータを新しいRUEIバージョンで引き続き表示できるようにする場合は、データをアップグレードする必要があります。RUEI 12.1.0.4システムが適切に動作するためには、データの変換は不要であることに注意してください。この手順が必要なのは、12.1.0.4のインストール前に処理および格納されたデータを表示できるようにする場合のみです。
12.1.0.4の新機能、データの格納および表示方法の変更点については、第3.1項「RUEI 12.1.0.4でのデータ表現の変更」を参照してください。
データのアップグレードは、個別の処理エンジンおよびレポータで実行する必要があります。
これは、古いデータの変換および新しいデータの収集のためにUSERS表領域の領域を解放するオプションの手順です。古いデータは個別の表領域に移動され、そこにバックアップとして残ります。
古いデータを保持する表領域(たとえば、UXBACKUP)を作成します。サイズはUSERS表領域とほぼ同じになりますが、必ず十分なデータベース・ファイルを追加できるようにしてください。
sqlplus sys/<password>@$RUEI_DB_TNSNAME as sysdba SQL> create tablespace UXBACKUP datafile 'uxbackup01.dbf' size 5M reuse autoextend on default compress; SQL> alter user RUEI_DB_USER quota unlimited on UXBACKUP; SQL> alter tablespace UXBACKUP add datafile 'uxbackup02.dbf' size 5M reuse autoextend on;
rootとしてログインした後、アップグレード・スクリプトから次の手順を実行します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh backup_data_cubes UXBACKUP
この項では、リリース12.1.0.4へのアップグレード後に、リリース11.1にロールバックする手順を説明します。レポータのインストールに含まれているコレクタは、説明されている手順の実行中に自動的にロールバックされます。ただし、リモート・コレクタ・システムは、個々にロールバックする必要があります。この手順については、この項で後ほど説明します。
|
重要: アップグレード前の状態に完全にシステムをリストアできない場合がある点に注意してください。アップグレードのロールバックを行う前に、Oracleサポート・サービスに連絡いただくことを強くお薦めします。データベースをリストアする手順については、『Oracle Enterprise Manager Cloud Control管理者ガイド』を参照してください。 |
次の手順では、11.1ディストリビューション・セットが/root/oldに抽出され、12.1.0.4ディストリビューション・セットが/rootに抽出されることを想定しています。
レポータ・システムにrootとしてログインします。/root/oldディレクトリ内でRUEI 11.1ディストリビューションzipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。
mkdir /root/old cd /root/old unzip<path to distribution set>/Vxxx.zip
次のコマンドを発行して、すべての処理を停止します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh stop_ruei
rootユーザーとして、RUEI_USERユーザーの.bash_profileファイル(RUEI_DATA/.bash_profile)から次の行を削除します。
source /etc/ruei.conf
source RUEI_HOME/bin/env.sh
rootとして次のコマンドを発行することで、12.1.0.4 rpmを削除します。
L=$(rpm -qa | grep ^ux-) rpm -e $L
次のコマンドを発行して、前のRPMをリストアします。
cd /root/old/RUEI/111 chmod +x ruei-install.sh ./ruei-install.sh reporter
次のコマンドを発行して、すべての処理を停止します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh stop_ruei
アップグレード中に作成したデータベース・バックアップをリストアします。
すべての必要なリモート・コレクタをロールバックします(第3.10.1項「リモート・コレクタ・システムのロールバック」で説明されている手順を使用)。完了したら、手順9に進みます。インストールでリモート・コレクタを使用しない場合は、すぐに手順9に進んでください。
(「システム」、「メンテナンス」、「バックアップおよびリストア」、「ファイルへのシステムのバックアップ」の順に選択して)アップグレード前に作成したバックアップを/tmpディレクトリなどにコピーしてレポータ・システムで使用できることを確認します。次に、rootユーザーとして次のコマンドを発行して、RUEI_USERユーザーによってバックアップ・ファイルを読取り可能にします。
chmod 644 /tmp/backup_file_name.tar.gz
RUEI_USERユーザーとして次のコマンドを発行して、バックアップ・ファイルをリストアします。
project -restore --all /tmp/backup_file_name.tar.gz
次を実行します。
リモート・コレクタ・システムにrootとしてログインします。/root/oldディレクトリ内で11.1ディストリビューションzipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを発行します。
mkdir /root/old cd /root/old unzip<path to distribution file>/Vxxx.zip
rootユーザーとして、RUEI_USERユーザーの.bash_profileファイル(RUEI_DATA/.bash_profile)から次の行を削除します。
source /etc/ruei.conf
source RUEI_HOME/bin/env.sh
次のコマンドを発行して、前のRPMをリストアします。
cd /root/old/RUEI/111 chmod +x ruei-install.sh ./ruei-install.sh ux-collector-*.rpm
必要なコレクタすべてについて完了したら、第3.10項「リリース11.1へのロールバック」の手順9に戻ります。
この項では、既存のRUEI 12.1.0.xインストールをリリース12.1.0.4にアップグレードするための手順について説明します。
|
重要: アップグレードを続行する前に、各プロセッサで個別に構成、メイン・データベースおよびデータベースをバックアップします。構成バックアップを実行するには、「システム」、「メンテナンス」の順に選択し、「バックアップおよびリストア」をクリックします。ロールバックの場合には、構成のバックアップが必要です。データベースをバックアップする手順については、『Oracle Enterprise Manager Cloud Control管理者ガイド』を参照してください。 |
この項で説明するレポータのアップグレード手順は、専用のレポータ・システムばかりでなく、単一サーバーのインストールにも適用できます。
次を実行します。
レポータにrootとしてログインします。/rootディレクトリ内でRUEI zipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。
cd /root
unzip Vxxxx.zip
次のコマンドを発行します。
cd /usr/java tar xzf /root/RUEI/Java/jre-7u25-linux-x64.tar.gz
Javaの使用許諾契約に同意するように要求されます。同意しなければ、先に進めません。
これにより、必要なJavaソフトウェアが/usr/java/jre1.7.0_25ディレクトリにインストールされます。インストール・ディレクトリをバージョンに依存しないものにするためには、次のコマンドを使用して、より一般的なsymlinkを作成します。
rm /usr/java/jre ln -s /usr/java/jre1.7.0_25 /usr/java/jre
次のコマンドを発行して、php-soapモジュールをインストールします。
rpm -Uhv php-soap-5.1.6-*.x86_64.rpm
|
注意: 12.1.0.3以前のバージョンからアップグレードしている場合のみ、この手順を実行します。 |
次のコマンドを使用して、レポータ・システムおよびコレクタ・システム上のすべての処理を停止します。
cd /root/RUEI/extra chmod +x ruei-upgrade-12.1.0.4.sh ./ruei-upgrade-12.1.0.4.sh stop_ruei
次のコマンドを実行して、アップグレード前に必要なアクションを実行します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh rpm_pre_install
デプロイメントによっては、アップグレード・アクションの完了に数時間かかる場合があります。
12.1.0.1以前のバージョンからアップグレードしている場合、この手順を実行する必要があります。
ruei-prepare-db.shスクリプトを、データベースがあるシステム上のOracleユーザーに提供します(たとえば、RUEIディストリビューションzipを抽出するなど)。次のコマンドを発行して、RUEIデータベース・インスタンスを更新します。
cd /root/RUEI/121 cp ruei-prepare-db.sh /home/oracle cp -r sql_scripts /home/oracle chmod +x /home/oracle/ruei-*.sh chmod +r /home/oracle/sql_scripts/* su - oracle export ORACLE_HOME=/u01/app/oracle/product/11.2.0/dbhome_1Foot 2 ./ruei-prepare-db.sh sql_packages ./ruei-prepare-db.sh user_grants ./ruei-prepare-db.sh set_incremental_stats
完了すると、再びrootユーザーになります。
必要なコレクタ・システムごとに、第3.11.2項「リモート・コレクタ・システムのアップグレード」で示されている手順を実行します。完了したら、手順9に進みます。
必要な処理エンジン・システムごとに、第3.11.3項「処理エンジン・システムのアップグレード」で示されている手順を実行します。完了したら、手順10に進みます。
次のコマンドを使用して、新しいリリースのRPMをインストールします。
cd /root/RUEI/121 chmod +x ruei-install.sh ./ruei-install.sh reporter
既存のインストール(アップグレード)では、次のコマンドを使用してRPMをインストールした後にフォントをコピーする必要があります。
cp RUEI_HOME/bi-publisher/fonts/* /usr/java/jre/lib/fonts/
rootユーザーとして、RUEI_USERの.bash_profileファイル(RUEI_DATA/.bash_profile)に次の行を追加します。
source /etc/ruei.conf
source RUEI_HOME/bin/env.sh
|
注意: 12.1.0.3からアップグレードしている場合は、この手順をスキップします。 |
表2-2で説明しているTZ設定を、適切なタイム・ゾーン文字列('Europe/Amsterdam'など)に設定します。適切なタイム・ゾーンを選択するには、tzselectプログラムを実行します。ORA_SDTZ (セッションのデフォルト・タイム・ゾーン)変数を、$TZと同じになるように設定する必要もあります。次に例を示します。
export TZ=Europe/Amsterdam export ORA_SDTZ=$TZ
次のコマンドを実行して、アップグレード後に必要なアクションを実行します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh rpm_post_install
第3.2項「KPI値」で説明されているように、アップグレード・スクリプトにより疑わしい履歴値およびターゲットの変換の確認を要求される場合があります。
バージョン12.1.0.0.0からアップグレードしている場合のみ、この手順を実行します。それ以外の場合は、この手順を省略できます。
前述の手順で行った選択を変更する場合、次のコマンドを実行して、この手順を再実行できます。
./ruei-upgrade-12.1.0.4.sh kpi_convert_percent
手順15を開始する前に、上のコマンドを実行する必要があります。
次のコマンドを使用して、処理を再起動します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh reinitialize ./ruei-upgrade-12.1.0.4.sh start_ruei
アップグレードにより、RUEI構成および現在のデータが新しいモデルに変換されました。ただし、古いデータを変換する必要があります。詳細は、第3.11.4項「履歴データのアップグレード」を参照してください。
|
注意: アップグレード中またはその後で、イベント・ログ( 「システム」、「ステータス」、「イベント・ログ」の順に選択)にエラーまたは情報メッセージが出現したら、アップグレード手順の完了後に既読としてマークし、新しいメッセージが報告されているかどうかを監視。エラー・メッセージが再び生じた場合、Oracleサポート・サービスにご連絡ください。 |
必要なコレクタ・システムごとに、rootとしてログインします。/rootディレクトリ内でRUEI zipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動して、新しいリリースのPRMをインストールします。次を実行します。
次のコマンドを使用して、RUEIディストリビューション・パッケージを解凍します。
cd /root
unzip Vxxxx.zip
次のコマンドを発行します。
cd /usr/java tar xzf /root/RUEI/Java/jre-7u25-linux-x64.tar.gz
Javaの使用許諾契約に同意するように要求されます。同意しなければ、先に進めません。
これにより、必要なJavaソフトウェアが/usr/java/jre1.7.0_25ディレクトリにインストールされます。インストール・ディレクトリをバージョンに依存しないものにするためには、次のコマンドを使用して、より一般的なsymlinkを作成します。
rm jre ln -s /usr/java/jre1.7.0_25 /usr/java/jre
次のコマンドを使用して、コレクタRPMをアップグレードします。
cd /root/RUEI/121 chmod +x ruei-install.sh ./ruei-install.sh collector
rootユーザーとして、RUEI_USERユーザーの.bash_profileファイル(RUEI_DATA/.bash_profile)に次の行を追加します。
source /etc/ruei.conf
source RUEI_HOME/bin/env.sh
12.1.0.3からアップグレードしている場合は、この手順をスキップします。
必要なコレクタ・システムごとに上の手順を完了した後、レポータ・システムのアップグレードを続行する必要があります(第3.11.1項「レポータ・システムのアップグレード」を参照)。
この項で説明されているアップグレード手順を処理エンジン・システムごとに実行する必要があります。処理エンジン・システムは、順にアップグレードする必要があります。つまり、前のシステムのアップグレードが完了するまで、次のシステムのアップグレードを開始しないでください。次を実行します。
rootとして処理エンジンにログインします。/rootディレクトリ内でRUEI zipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。
cd /root
unzip Vxxxx.zip
次のコマンドを発行します。
cd /usr/java tar xzf /root/RUEI/Java/jre-7u25-linux-x64.tar.gz
Javaの使用許諾契約に同意するように要求されます。同意しなければ、先に進めません。
これにより、必要なJavaソフトウェアが/usr/java/jre1.7.0_25ディレクトリにインストールされます。インストール・ディレクトリをバージョンに依存しないものにするためには、次のコマンドを使用して、より一般的なsymlinkを作成します。
rm /usr/java/jre ln -s /usr/java/jre1.7.0_25 /usr/java/jre
次のコマンドを実行して、アップグレード前に必要なアクションを実行します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh rpm_pre_install
12.1.0.1以前のバージョンからアップグレードしている場合のみ、この手順を実行する必要があります。
ruei-prepare.shスクリプトを、データベースがあるシステム上のOracleユーザーに提供します(たとえば、RUEIディストリビューションzipを抽出するなど) 。次のコマンドを発行して、処理エンジン・データベース・インスタンスを更新します。
cd /root/RUEI/121 cp ruei-prepare-db.sh /home/oracle cp -r sql_scripts /home/oracle chmod +x /home/oracle/ruei-*.sh chmod +r /home/oracle/sql_scripts/* su - oracle export ORACLE_HOME=/u01/app/oracle/product/11.2.0/dbhome_1Foot 3 ./ruei-prepare-db.sh sql_packages ./ruei-prepare-db.sh user_grants
完了すると、再びrootユーザーになります。
次のコマンドを使用して、新しいリリースのRPMをインストールします。
cd /root/RUEI/121 chmod +x ruei-install.sh ./ruei-install.sh processor
rootユーザーとして、RUEI_USERの.bash_profileファイル(RUEI_DATA/.bash_profile)に次の行を追加します。
source /etc/ruei.conf
source RUEI_HOME/bin/env.sh
12.1.0.3からアップグレードしている場合は、この手順をスキップします。
必要な処理エンジンごとに上の手順を完了した後、レポータ・システムのアップグレードを続行する必要があります(第3.11.1項「レポータ・システムのアップグレード」を参照)。
RUEI 12.1.0.4ではデータの格納および問合せに新しいデータ・モデルを使用するため、12.1.0.4以前のデータを新しいRUEIバージョンで引き続き表示できるようにする場合は、データをアップグレードする必要があります。RUEI 12.1.0.4システムが適切に動作するためには、データの変換は不要であることに注意してください。この手順が必要なのは、12.1.0.4のインストール前に処理および格納されたデータを表示できるようにする場合のみです。
12.1.0.4の新機能、データの格納および表示方法の変更点については、第3.1項「RUEI 12.1.0.4でのデータ表現の変更」を参照してください。
データのアップグレードは、個別の処理エンジンおよびレポータで実行する必要があります。
これは、古いデータの変換および新しいデータの収集のためにUSERS表領域の領域を解放するオプションの手順です。古いデータは個別の表領域に移動され、そこにバックアップとして残ります。
古いデータを保持する表領域(たとえば、UXBACKUP)を作成します。サイズはUSERS表領域とほぼ同じになりますが、必ず十分なデータベース・ファイルを追加できるようにしてください。
sqlplus sys/<password>@$RUEI_DB_TNSNAME as sysdba SQL> create tablespace UXBACKUP datafile 'uxbackup01.dbf' size 5M reuse autoextend on default compress; SQL> alter user RUEI_DB_USER quota unlimited on UXBACKUP; SQL> alter tablespace UXBACKUP add datafile 'uxbackup02.dbf' size 5M reuse autoextend on;
rootとしてログインした後、アップグレード・スクリプトから次の手順を実行します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh backup_data_cubes UXBACKUP
この項では、リリース12.1.0.4へのアップグレード後に、リリース12.1.0.xにロールバックする手順を説明します。レポータのインストールに含まれているコレクタは、説明されている手順の実行中に自動的にロールバックされます。ただし、リモート・コレクタ・システムは、個々にロールバックする必要があります。この手順については、この項で後ほど説明します。
|
重要: アップグレード前の状態に完全にシステムをリストアできない場合がある点に注意してください。アップグレードのロールバックを行う前に、Oracleサポート・サービスに連絡いただくことを強くお薦めします。データベースをリストアする手順については、『Oracle Enterprise Manager Cloud Control管理者ガイド』を参照してください。 |
次の手順では、12.1.0.xディストリビューション・セットが/root/oldに抽出され、12.1.0.4ディストリビューション・セットが/rootに抽出されることを想定しています。
レポータ・システムにrootとしてログインします。/root/oldディレクトリ内でRUEI 12.1.0.xディストリビューションzipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。
mkdir /root/old cd /root/old unzip<path to distribution set>/Vxxx.zip
次のコマンドを発行して、すべての処理を停止します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh stop_ruei
rootユーザーとして、RUEI_USERユーザーの.bash_profileファイル(RUEI_DATA/.bash_profile)から次の行を削除します。
source /etc/ruei.conf
source RUEI_HOME/bin/env.sh
12.1.0.3からアップグレードしている場合は、この手順をスキップします。
rootとして次のコマンドを発行することで、12.1.0.4 RPMを削除します。
L=$(rpm -qa | grep ^ux-) rpm -e $L
次のコマンドを発行して、前のRPMをリストアします。
cd /root/old/RUEI/121 chmod +x ruei-install.sh ./ruei-install.sh reporter
次のコマンドを発行して、すべての処理を停止します。
cd /root/RUEI/extra ./ruei-upgrade-12.1.0.4.sh stop_ruei
アップグレード中に作成したデータベース・バックアップをリストアします。
すべての必要なリモート・コレクタをロールバックします(第3.12.1項「リモート・コレクタ・システムのロールバック」で説明されている手順を使用)。インストールでリモート・コレクタを使用しない場合は、すぐに手順9に進んでください。
すべての必要な処理エンジン・システムをロールバックします(第3.12.2項「処理エンジン・システムのロールバック」で説明されている手順を使用)。インストールで処理エンジンを使用しない場合は、すぐに手順10に進んでください。
(「システム」、「メンテナンス」、「バックアップおよびリストア」、「ファイルへのシステムのバックアップ」の順に選択して)アップグレード前に作成したバックアップを/tmpディレクトリなどにコピーしてレポータ・システムで使用できることを確認します。次に、rootユーザーとして次のコマンドを発行して、RUEI_USERユーザーによってバックアップ・ファイルを読取り可能にします。
chmod 644 /tmp/backup_file_name.tar.gz
RUEI_USERユーザーとして次のコマンドを発行して、バックアップ・ファイルをリストアします。
project -restore --collectors /tmp/backup_file_name.tar.gz
次を実行します。
リモート・コレクタ・システムにrootとしてログインします。/root/oldディレクトリ内で12.1.0.xディストリビューションzipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを発行します。
mkdir /root/old cd /root/old unzip<path to distribution file>/Vxxx.zip
rootユーザーとして、RUEI_USERユーザーの.bash_profileファイル(RUEI_DATA/.bash_profile)から次の行を削除します。
source /etc/ruei.conf
source RUEI_HOME/bin/env.sh
12.1.0.3からアップグレードしている場合は、この手順をスキップします。
次のコマンドを発行して、前のRPMをリストアします。
cd /root/old/RUEI/121 chmod +x ruei-install.sh ./ruei-install.sh ux-collector-*.rpm
必要なコレクタすべてについて完了したら、第3.12項「リリース12.1.0.xへのロールバック」の手順9に戻ります。
次を実行します。
rootとして処理エンジン・システムにログインします。/root/oldディレクトリ内でRUEI 12.1.0.xディストリビューションzipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。
mkdir /root/old cd /root/old unzip<path to distribution set>/Vxxx.zip
rootユーザーとして、RUEI_USERユーザーの.bash_profileファイル(RUEI_DATA/.bash_profile)から次の行を削除します。
source /etc/ruei.conf
source RUEI_HOME/bin/env.sh
12.1.0.3からアップグレードしている場合は、この手順をスキップします。
次のコマンドを発行して、前のRPMをリストアします。
cd /root/old/RUEI/121 chmod +x ruei-install.sh ./ruei-install.sh processor
必要な処理エンジンすべてについて完了したら、第3.12項「リリース12.1.0.xへのロールバック」の手順10に戻ります。
脚注の説明
脚注1: この行は、データベース・バージョンとインストール・パスに基づいてカスタマイズする必要があります。