ヘッダーをスキップ

Oracle® Real User Experience Insightインストレーション・ガイド 12c リリース3 (12.1.0.4) for Linux x86-64 E49734-01 |
| 目次 | 索引

前 | 次 |

# 3 RUEI 12.1.0.4へのアップグレード

この章では、既存の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サポート・サービスへのリクエストに添付してください。

## 3.1 RUEI 12.1.0.4でのデータ表現の変更

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.1 BIエクスポートの変更

第3.1項「RUEI 12.1.0.4でのデータ表現の変更」で説明している変更は、BIエクスポート内のすべてのRUEI表に適用できます。つまり、RUEI 12.1.0.4にアップグレードした後、BIエクスポート表内のデータが異なった方法で表示されます。

新しいデータ表現が、RUEI BIエクスポート・ユーティリティを使用するアプリケーションと互換性がないことを確認してください。

## 3.2 KPI値

12.1.0.0.1以前のバージョンで、KPIパーセント値が0および100の間ではなく0および1の間の数値として誤って報告される場合があります。アップグレード・スクリプトは、疑わしいKPI履歴値およびターゲットの修正の確認を要求します。これは、第3.9.1項「レポータ・システムのアップグレード」で説明されています。

履歴データおよびターゲット値が必要に応じて正しく変換されていることを確認する最善の努力を行う一方で、要件を満たすKPIレポートおよびターゲット構成を確認することをお薦めします。

## 3.3 XPathのサポート

リリース11.1では、XPathクエリーのサポートが拡張され、コンテンツ・スキャニング用の完全なXPath 1.0機能が提供されるようになりました。これは既存のRUEIインストールをアップグレードする際に大きな影響があります。

アップグレード・スクリプトは、現在の構成で検出されたすべてのネームスペースを報告します。アップグレード・プロセス完了時にこれらを明示的に定義する必要があります。定義しなかった場合は、構成が正しく機能しません。

さらに、形式が正しくないXHTMLコードに対して実行されたXPath式は、前のバージョンとは異なる結果を返すことがある点にも注意してください。したがって、RUEIインストールで使用されるすべてのXPath式を慎重に確認することを強くお薦めします。XPathサポートに関する詳細は、『Oracle Real User Experience Insightユーザーズ・ガイド』を参照してください。

## 3.4 増加したデータベース領域の要件

バージョン12.1.0.1の時点で、データ・ブラウザ・グループ内の毎時間情報の追加によって、必要なデータベース領域の量が大幅に増加しました。レポート要件を満たしていることを確認するため、データベース使用状況およびデータ保存ポリシーを定期的に確認することをお薦めします。

## 3.5 デフォルトの表領域モード

バージョン12.1.0.3の時点で、新しいインストール内の`USERS`および`UXCONF`表領域がデフォルトで`force` `logging`モードに設定されます。このモードは、オンライン・データベース・バックアップの作成に必要です。以前のデフォルト・モードは`nologging`でした。この構成を変更する手順は、Oracle Real User Experience Insightアドバンスト管理者ガイドで説明されています。

既存のユーザーは、`force` `logging`モードを使用せずに作成されたデータベース・バックアップは使用できない可能性があることに注意する必要があります。アップグレード手順は、データベースの現在の設定を変更しません。ただし、`force` `logging`への表領域モードの変更によってディスクI/Oが大幅に増加する可能性があることに注意してください。

## 3.6 application.nameおよびapplication.page-groupフィルタのアップグレード

アプリケーション名が、かっこで囲まれたスイート名を含むサブアプリケーションの場合、またはページ-グループ値が、複数のページ名を含むグループではなく実際のページ名である場合、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

## 3.7 フレームワーク例外のダウンロード

以前のリリース・バージョンからのフレームワーク例外ダウンロードzipファイルは、12.1.0.4と互換性がありません。アップグレードが完了したら、zipファイルを再びダウンロードして12.1.0.4と互換性のあるバージョンを入手します。

## 3.8 ruei.confファイル内の設定

バージョン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

## 3.9 RUEI 11.1から12.1.0.4へのアップグレード

この項では、既存のRUEI 11.1インストールをリリース12.1.0.4にアップグレードするための手順について説明します。

重要: アップグレードを続行する前に、各プロセッサで個別に構成、メイン・データベースおよびデータベースをバックアップします。「システム」、「メンテナンス」の順に選択し、「バックアップおよびリストア」をクリックします。ロールバックの場合には、構成のバックアップが必要です。 データベースをバックアップする手順については、『Oracle Enterprise Manager Cloud Control管理者ガイド』を参照してください。

### 3.9.1 レポータ・システムのアップグレード

この項で説明するレポータのアップグレード手順は、専用のレポータ・システムばかりでなく、単一サーバーのインストールにも適用できます。

次を実行します。

1. レポータに`root`としてログインします。`/root`ディレクトリ内でRUEI zipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。

       cd /root
       unzip Vxxxx.zip

2. 次のコマンドを発行します。

       cd /usr/java
       tar xzf /root/RUEI/Java/jre-7u25-linux-x64.tar.gz

   Javaの使用許諾契約に同意するように要求されます。同意しなければ、先に進めません。

3. これにより、必要なJavaソフトウェアが`/usr/java/jre1.7.0_25`ディレクトリにインストールされます。インストール・ディレクトリをバージョンに依存しないものにするためには、次のコマンドを使用して、より一般的なsymlinkを作成します。

       rm ./jre
       ln -s /usr/java/jre1.7.0_25 /usr/java/jre

4. 次のコマンドを発行して、`php-soap`モジュールをインストールします。

       rpm -Uhv php-soap-5.1.6-*.x86_64.rpm

5. 次のコマンドを使用して、レポータ・システムおよびコレクタ・システム上のすべての処理を停止します。

       cd /root/RUEI/extra
       chmod +x ruei-upgrade-12.1.0.4.sh
       ./ruei-upgrade-12.1.0.4.sh stop_ruei

6. `/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

7. 次のコマンドを実行して、アップグレード前に必要なアクションを実行します。

       cd /root/RUEI/extra
       ./ruei-upgrade-12.1.0.4.sh rpm_pre_install

   デプロイメントによっては、アップグレード・アクションの完了に数時間かかる場合があります。

8. `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`ユーザーになります。

9. 必要なコレクタ・システムごとに、第3.9.2項「リモート・コレクタ・システムのアップグレード」で示されている手順を実行します。完了したら、手順10に進みます。

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/

11. `root`ユーザーとして、`RUEI_USER`ユーザーの`.bash_profile`ファイル(`RUEI_DATA``/.bash_profile`)に次の行を追加します。

        source /etc/ruei.conf
        source RUEI_HOME/bin/env.sh

12. 次のコマンドを実行して、アップグレード後に必要なアクションを実行します。

        cd /root/RUEI/extra
        ./ruei-upgrade-12.1.0.4.sh rpm_post_install

    第3.2項「KPI値」で説明されているように、アップグレード・スクリプトにより疑わしい履歴値およびターゲットの変換の確認を要求される場合があります。

    上で行った選択を変更する場合、次のコマンドを実行して、この手順を再実行できます。

13.     ./ruei-upgrade-12.1.0.4.sh kpi_convert_percent

    手順11を開始する前に、上のコマンドを実行する必要があります。

14. 次のコマンドを使用して、処理を再起動します。

        cd /root/RUEI/extra
        ./ruei-upgrade-12.1.0.4.sh reinitialize
        ./ruei-upgrade-12.1.0.4.sh start_ruei

15. アップグレードでは、RUEI構成および現在のデータが新しいモデルに変換されます。ただし、古いデータはまだ変換されていません。詳細は、第3.9.3項「履歴データのアップグレード」を参照してください。

注意: アップグレード中またはその後で、イベント・ログ( 「システム」、「ステータス」、「イベント・ログ」の順に選択)にエラーまたは情報メッセージが出現したら、アップグレード手順の完了後に既読としてマークし、新しいメッセージが報告されているかどうかを監視。エラー・メッセージが再び生じた場合、Oracleサポート・サービスにご連絡ください。

### 3.9.2 リモート・コレクタ・システムのアップグレード

必要なコレクタ・システムごとに、`root`としてログインします。`/root`ディレクトリ内でRUEI zipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動して、新しいリリースのPRMをインストールします。次を実行します。

1. 次のコマンドを使用して、RUEIディストリビューション・パッケージを解凍します。

       cd /root
       unzip Vxxxx.zip

2. 次のコマンドを発行します。

       cd /usr/java
       tar xzf /root/RUEI/Java/jre-7u25-linux-x64.tar.gz

   Javaの使用許諾契約に同意するように要求されます。同意しなければ、先に進めません。

3. これにより、必要なJavaソフトウェアが`/usr/java/jre1.7.0_09`ディレクトリにインストールされます。インストール・ディレクトリをバージョンに依存しないものにするためには、次のコマンドを使用して、より一般的なsymlinkを作成します。

       rm ./jre
       ln -s /usr/java/jre1.7.0_25 /usr/java/jre

4. 次のコマンドを使用して、コレクタRPMをアップグレードします。

       cd /root/RUEI/121
       chmod +x ruei-install.sh
       ./ruei-install.sh collector

5. `root`ユーザーとして、`RUEI_USER`ユーザーの`.bash_profile`ファイル(`RUEI_DATA``/.bash_profile`)に次の行を追加します。

       source /etc/ruei.conf
       source RUEI_HOME/bin/env.sh

必要なコレクタ・システムごとに上の手順を完了した後、レポータ・システムのアップグレードを続行する必要があります(第3.9.1項「レポータ・システムのアップグレード」を参照)。

### 3.9.3 履歴データのアップグレード

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でのデータ表現の変更」を参照してください。

データのアップグレードは、個別の処理エンジンおよびレポータで実行する必要があります。

#### 3.9.3.1 個別の表領域への古いデータの移動

これは、古いデータの変換および新しいデータの収集のためにUSERS表領域の領域を解放するオプションの手順です。古いデータは個別の表領域に移動され、そこにバックアップとして残ります。

1. 古いデータを保持する表領域(たとえば、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;

2. rootとしてログインした後、アップグレード・スクリプトから次の手順を実行します。

       cd /root/RUEI/extra
       ./ruei-upgrade-12.1.0.4.sh backup_data_cubes UXBACKUP

#### 3.9.3.2 データの変換

構成されなくなったアプリケーションのデータは変換されないことに注意してください。このデータを保持するために、変換を実行する前に同じ名前を使用して「構成」 > 「アプリケーション」/「サービス」画面でデータを戻します。

rootとしてログインした後、アップグレード・スクリプトから次の手順を実行します。

    cd /root/RUEI/extra
    ./ruei-upgrade-12.1.0.4.sh convert_data_cubes

システム内のデータの量によって、これは完了するまでに長い時間がかかる可能性があります。

#### 3.9.3.3 元のデータの削除

アップグレード中に問題が発生した場合、元のデータ・キューブはバックアップとして保持されます。データのアップグレードが完了した後、rootとしてログインして次を実行することで完全に削除できます。

    cd /root/RUEI/extra
    ./ruei-upgrade-12.1.0.4.sh delete_old_data

これにより、RUEI 12.1.0.4以前のデータ・キューブが完全に削除されます。

## 3.10 リリース11.1へのロールバック

この項では、リリース12.1.0.4へのアップグレード後に、リリース11.1にロールバックする手順を説明します。レポータのインストールに含まれているコレクタは、説明されている手順の実行中に自動的にロールバックされます。ただし、リモート・コレクタ・システムは、個々にロールバックする必要があります。この手順については、この項で後ほど説明します。

重要: アップグレード前の状態に完全にシステムをリストアできない場合がある点に注意してください。アップグレードのロールバックを行う前に、Oracleサポート・サービスに連絡いただくことを強くお薦めします。データベースをリストアする手順については、『Oracle Enterprise Manager Cloud Control管理者ガイド』を参照してください。

次の手順では、11.1ディストリビューション・セットが`/root/old`に抽出され、12.1.0.4ディストリビューション・セットが`/root`に抽出されることを想定しています。

1. レポータ・システムに`root`としてログインします。`/root/old`ディレクトリ内でRUEI 11.1ディストリビューションzipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。

       mkdir /root/old
       cd /root/old
       unzip <path to distribution set>/Vxxx.zip

2. 次のコマンドを発行して、すべての処理を停止します。

       cd /root/RUEI/extra
       ./ruei-upgrade-12.1.0.4.sh stop_ruei

3. `root`ユーザーとして、`RUEI_USER`ユーザーの`.bash_profile`ファイル(`RUEI_DATA``/.bash_profile`)から次の行を削除します。

       source /etc/ruei.conf
       source RUEI_HOME/bin/env.sh

4. rootとして次のコマンドを発行することで、12.1.0.4 rpmを削除します。

       L=$(rpm -qa | grep ^ux-)
       rpm -e $L

5. 次のコマンドを発行して、前のRPMをリストアします。

       cd /root/old/RUEI/111
       chmod +x ruei-install.sh
       ./ruei-install.sh reporter

6. 次のコマンドを発行して、すべての処理を停止します。

       cd /root/RUEI/extra
       ./ruei-upgrade-12.1.0.4.sh stop_ruei

7. アップグレード中に作成したデータベース・バックアップをリストアします。

8. すべての必要なリモート・コレクタをロールバックします(第3.10.1項「リモート・コレクタ・システムのロールバック」で説明されている手順を使用)。完了したら、手順9に進みます。インストールでリモート・コレクタを使用しない場合は、すぐに手順9に進んでください。

9. (「システム」、「メンテナンス」、「バックアップおよびリストア」、「ファイルへのシステムのバックアップ」の順に選択して)アップグレード前に作成したバックアップを`/tmp`ディレクトリなどにコピーしてレポータ・システムで使用できることを確認します。次に、`root`ユーザーとして次のコマンドを発行して、`RUEI_USER`ユーザーによってバックアップ・ファイルを読取り可能にします。

       chmod 644 /tmp/backup_file_name.tar.gz

10. `RUEI_USER`ユーザーとして次のコマンドを発行して、バックアップ・ファイルをリストアします。

        project -restore --all /tmp/backup_file_name.tar.gz

### 3.10.1 リモート・コレクタ・システムのロールバック

次を実行します。

1. リモート・コレクタ・システムに`root`としてログインします。`/root/old`ディレクトリ内で11.1ディストリビューションzipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを発行します。

       mkdir /root/old
       cd /root/old
       unzip <path to distribution file>/Vxxx.zip

2. `root`ユーザーとして、`RUEI_USER`ユーザーの`.bash_profile`ファイル(`RUEI_DATA``/.bash_profile`)から次の行を削除します。

       source /etc/ruei.conf
       source RUEI_HOME/bin/env.sh

3. 次のコマンドを発行して、前のRPMをリストアします。

       cd /root/old/RUEI/111
       chmod +x ruei-install.sh
       ./ruei-install.sh ux-collector-*.rpm

必要なコレクタすべてについて完了したら、第3.10項「リリース11.1へのロールバック」の手順9に戻ります。

## 3.11 RUEI 12.1.0.xから12.1.0.4へのアップグレード

この項では、既存のRUEI 12.1.0.xインストールをリリース12.1.0.4にアップグレードするための手順について説明します。

重要: アップグレードを続行する前に、各プロセッサで個別に構成、メイン・データベースおよびデータベースをバックアップします。構成バックアップを実行するには、「システム」、「メンテナンス」の順に選択し、「バックアップおよびリストア」をクリックします。ロールバックの場合には、構成のバックアップが必要です。 データベースをバックアップする手順については、『Oracle Enterprise Manager Cloud Control管理者ガイド』を参照してください。

### 3.11.1 レポータ・システムのアップグレード

この項で説明するレポータのアップグレード手順は、専用のレポータ・システムばかりでなく、単一サーバーのインストールにも適用できます。

次を実行します。

1. レポータに`root`としてログインします。`/root`ディレクトリ内でRUEI zipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。

       cd /root
       unzip Vxxxx.zip

2. 次のコマンドを発行します。

       cd /usr/java
       tar xzf /root/RUEI/Java/jre-7u25-linux-x64.tar.gz

   Javaの使用許諾契約に同意するように要求されます。同意しなければ、先に進めません。

3. これにより、必要なJavaソフトウェアが`/usr/java/jre1.7.0_25`ディレクトリにインストールされます。インストール・ディレクトリをバージョンに依存しないものにするためには、次のコマンドを使用して、より一般的なsymlinkを作成します。

       rm /usr/java/jre
       ln -s /usr/java/jre1.7.0_25 /usr/java/jre

4. 次のコマンドを発行して、`php-soap`モジュールをインストールします。

       rpm -Uhv php-soap-5.1.6-*.x86_64.rpm

   注意: 12.1.0.3以前のバージョンからアップグレードしている場合のみ、この手順を実行します。

5. 次のコマンドを使用して、レポータ・システムおよびコレクタ・システム上のすべての処理を停止します。

       cd /root/RUEI/extra
       chmod +x ruei-upgrade-12.1.0.4.sh
       ./ruei-upgrade-12.1.0.4.sh stop_ruei

6. 次のコマンドを実行して、アップグレード前に必要なアクションを実行します。

       cd /root/RUEI/extra
       ./ruei-upgrade-12.1.0.4.sh rpm_pre_install

   デプロイメントによっては、アップグレード・アクションの完了に数時間かかる場合があります。

7. 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`ユーザーになります。

8. 必要なコレクタ・システムごとに、第3.11.2項「リモート・コレクタ・システムのアップグレード」で示されている手順を実行します。完了したら、手順9に進みます。

9. 必要な処理エンジン・システムごとに、第3.11.3項「処理エンジン・システムのアップグレード」で示されている手順を実行します。完了したら、手順10に進みます。

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/

11. `root`ユーザーとして、`RUEI_USER`の`.bash_profile`ファイル(`RUEI_DATA``/.bash_profile`)に次の行を追加します。

        source /etc/ruei.conf
        source RUEI_HOME/bin/env.sh

    注意: 12.1.0.3からアップグレードしている場合は、この手順をスキップします。

12. 表2-2で説明している`TZ`設定を、適切なタイム・ゾーン文字列('Europe/Amsterdam'など)に設定します。適切なタイム・ゾーンを選択するには、`tzselect`プログラムを実行します。`ORA_SDTZ` (セッションのデフォルト・タイム・ゾーン)変数を、`$TZ`と同じになるように設定する必要もあります。次に例を示します。

        export TZ=Europe/Amsterdam
        export ORA_SDTZ=$TZ

13. 次のコマンドを実行して、アップグレード後に必要なアクションを実行します。

        cd /root/RUEI/extra
        ./ruei-upgrade-12.1.0.4.sh rpm_post_install

    第3.2項「KPI値」で説明されているように、アップグレード・スクリプトにより疑わしい履歴値およびターゲットの変換の確認を要求される場合があります。

14. バージョン12.1.0.0.0からアップグレードしている場合のみ、この手順を実行します。それ以外の場合は、この手順を省略できます。

    前述の手順で行った選択を変更する場合、次のコマンドを実行して、この手順を再実行できます。

        ./ruei-upgrade-12.1.0.4.sh kpi_convert_percent

    手順15を開始する前に、上のコマンドを実行する必要があります。

15. 次のコマンドを使用して、処理を再起動します。

        cd /root/RUEI/extra
        ./ruei-upgrade-12.1.0.4.sh reinitialize
        ./ruei-upgrade-12.1.0.4.sh start_ruei

16. アップグレードにより、RUEI構成および現在のデータが新しいモデルに変換されました。ただし、古いデータを変換する必要があります。詳細は、第3.11.4項「履歴データのアップグレード」を参照してください。

注意: アップグレード中またはその後で、イベント・ログ( 「システム」、「ステータス」、「イベント・ログ」の順に選択)にエラーまたは情報メッセージが出現したら、アップグレード手順の完了後に既読としてマークし、新しいメッセージが報告されているかどうかを監視。エラー・メッセージが再び生じた場合、Oracleサポート・サービスにご連絡ください。

### 3.11.2 リモート・コレクタ・システムのアップグレード

必要なコレクタ・システムごとに、`root`としてログインします。`/root`ディレクトリ内でRUEI zipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動して、新しいリリースのPRMをインストールします。次を実行します。

1. 次のコマンドを使用して、RUEIディストリビューション・パッケージを解凍します。

       cd /root
       unzip Vxxxx.zip

2. 次のコマンドを発行します。

       cd /usr/java
       tar xzf /root/RUEI/Java/jre-7u25-linux-x64.tar.gz

   Javaの使用許諾契約に同意するように要求されます。同意しなければ、先に進めません。

3. これにより、必要なJavaソフトウェアが`/usr/java/jre1.7.0_25`ディレクトリにインストールされます。インストール・ディレクトリをバージョンに依存しないものにするためには、次のコマンドを使用して、より一般的なsymlinkを作成します。

       rm jre
       ln -s /usr/java/jre1.7.0_25 /usr/java/jre

4. 次のコマンドを使用して、コレクタRPMをアップグレードします。

       cd /root/RUEI/121
       chmod +x ruei-install.sh
       ./ruei-install.sh collector

5. `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項「レポータ・システムのアップグレード」を参照)。

### 3.11.3 処理エンジン・システムのアップグレード

この項で説明されているアップグレード手順を処理エンジン・システムごとに実行する必要があります。処理エンジン・システムは、順にアップグレードする必要があります。つまり、前のシステムのアップグレードが完了するまで、次のシステムのアップグレードを開始しないでください。次を実行します。

1. `root`として処理エンジンにログインします。`/root`ディレクトリ内でRUEI zipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。

       cd /root
       unzip Vxxxx.zip

2. 次のコマンドを発行します。

       cd /usr/java
       tar xzf /root/RUEI/Java/jre-7u25-linux-x64.tar.gz

   Javaの使用許諾契約に同意するように要求されます。同意しなければ、先に進めません。

3. これにより、必要なJavaソフトウェアが`/usr/java/jre1.7.0_25`ディレクトリにインストールされます。インストール・ディレクトリをバージョンに依存しないものにするためには、次のコマンドを使用して、より一般的なsymlinkを作成します。

       rm /usr/java/jre
       ln -s /usr/java/jre1.7.0_25 /usr/java/jre

4. 次のコマンドを実行して、アップグレード前に必要なアクションを実行します。

       cd /root/RUEI/extra
       ./ruei-upgrade-12.1.0.4.sh rpm_pre_install

5. 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`ユーザーになります。

6. 次のコマンドを使用して、新しいリリースのRPMをインストールします。

       cd /root/RUEI/121
       chmod +x ruei-install.sh
       ./ruei-install.sh processor

7. `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項「レポータ・システムのアップグレード」を参照)。

### 3.11.4 履歴データのアップグレード

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でのデータ表現の変更」を参照してください。

データのアップグレードは、個別の処理エンジンおよびレポータで実行する必要があります。

#### 3.11.4.1 個別の表領域への古いデータの移動

これは、古いデータの変換および新しいデータの収集のためにUSERS表領域の領域を解放するオプションの手順です。古いデータは個別の表領域に移動され、そこにバックアップとして残ります。

1. 古いデータを保持する表領域(たとえば、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;

2. rootとしてログインした後、アップグレード・スクリプトから次の手順を実行します。

       cd /root/RUEI/extra
       ./ruei-upgrade-12.1.0.4.sh backup_data_cubes UXBACKUP

#### 3.11.4.2 データの変換

構成されなくなったアプリケーションのデータは変換されないことに注意してください。このデータを保持するために、変換を実行する前に同じ名前を使用して「構成」 > 「アプリケーション」/「サービス」画面でデータを戻します。

rootとしてログインした後、アップグレード・スクリプトから次の手順を実行します。

    cd /root/RUEI/extra
    ./ruei-upgrade-12.1.0.4.sh convert_data_cubes

システム内のデータの量によって、これは完了するまでに長い時間がかかる可能性があります。

#### 3.11.4.3 元のデータの削除

アップグレード中に問題が発生した場合、元のデータ・キューブはバックアップとして保持されます。データのアップグレードが完了した後、rootとしてログインして次を実行することで完全に削除できます。

    cd /root/RUEI/extra
    ./ruei-upgrade-12.1.0.4.sh delete_old_data

これにより、RUEI 12.1.0.4以前のデータ・キューブが完全に削除されます。

## 3.12 リリース12.1.0.xへのロールバック

この項では、リリース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`に抽出されることを想定しています。

1. レポータ・システムに`root`としてログインします。`/root/old`ディレクトリ内でRUEI 12.1.0.xディストリビューションzipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。

       mkdir /root/old
       cd /root/old
       unzip <path to distribution set>/Vxxx.zip

2. 次のコマンドを発行して、すべての処理を停止します。

       cd /root/RUEI/extra
       ./ruei-upgrade-12.1.0.4.sh stop_ruei

3. `root`ユーザーとして、`RUEI_USER`ユーザーの`.bash_profile`ファイル(`RUEI_DATA``/.bash_profile`)から次の行を削除します。

       source /etc/ruei.conf
       source RUEI_HOME/bin/env.sh

   12.1.0.3からアップグレードしている場合は、この手順をスキップします。

4. rootとして次のコマンドを発行することで、12.1.0.4 RPMを削除します。

       L=$(rpm -qa | grep ^ux-)
       rpm -e $L

5. 次のコマンドを発行して、前のRPMをリストアします。

       cd /root/old/RUEI/121
       chmod +x ruei-install.sh
       ./ruei-install.sh reporter

6. 次のコマンドを発行して、すべての処理を停止します。

       cd /root/RUEI/extra
       ./ruei-upgrade-12.1.0.4.sh stop_ruei

7. アップグレード中に作成したデータベース・バックアップをリストアします。

8. すべての必要なリモート・コレクタをロールバックします(第3.12.1項「リモート・コレクタ・システムのロールバック」で説明されている手順を使用)。インストールでリモート・コレクタを使用しない場合は、すぐに手順9に進んでください。

9. すべての必要な処理エンジン・システムをロールバックします(第3.12.2項「処理エンジン・システムのロールバック」で説明されている手順を使用)。インストールで処理エンジンを使用しない場合は、すぐに手順10に進んでください。

10. (「システム」、「メンテナンス」、「バックアップおよびリストア」、「ファイルへのシステムのバックアップ」の順に選択して)アップグレード前に作成したバックアップを`/tmp`ディレクトリなどにコピーしてレポータ・システムで使用できることを確認します。次に、`root`ユーザーとして次のコマンドを発行して、`RUEI_USER`ユーザーによってバックアップ・ファイルを読取り可能にします。

        chmod 644 /tmp/backup_file_name.tar.gz

11. `RUEI_USER`ユーザーとして次のコマンドを発行して、バックアップ・ファイルをリストアします。

        project -restore --collectors /tmp/backup_file_name.tar.gz

### 3.12.1 リモート・コレクタ・システムのロールバック

次を実行します。

1. リモート・コレクタ・システムに`root`としてログインします。`/root/old`ディレクトリ内で12.1.0.xディストリビューションzipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを発行します。

       mkdir /root/old
       cd /root/old
       unzip <path to distribution file>/Vxxx.zip

2. `root`ユーザーとして、`RUEI_USER`ユーザーの`.bash_profile`ファイル(`RUEI_DATA``/.bash_profile`)から次の行を削除します。

       source /etc/ruei.conf
       source RUEI_HOME/bin/env.sh

   12.1.0.3からアップグレードしている場合は、この手順をスキップします。

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に戻ります。

### 3.12.2 処理エンジン・システムのロールバック

次を実行します。

1. `root`として処理エンジン・システムにログインします。`/root/old`ディレクトリ内でRUEI 12.1.0.xディストリビューションzipファイルを解凍し、アプリケーション・ファイルが格納されているディレクトリに移動します。次のコマンドを使用します。

       mkdir /root/old
       cd /root/old
       unzip <path to distribution set>/Vxxx.zip

2. `root`ユーザーとして、`RUEI_USER`ユーザーの`.bash_profile`ファイル(`RUEI_DATA``/.bash_profile`)から次の行を削除します。

       source /etc/ruei.conf
       source RUEI_HOME/bin/env.sh

   12.1.0.3からアップグレードしている場合は、この手順をスキップします。

3. 次のコマンドを発行して、前のRPMをリストアします。

       cd /root/old/RUEI/121
       chmod +x ruei-install.sh
       ./ruei-install.sh processor

必要な処理エンジンすべてについて完了したら、第3.12項「リリース12.1.0.xへのロールバック」の手順10に戻ります。

脚注の説明

脚注1: この行は、データベース・バージョンとインストール・パスに基づいてカスタマイズする必要があります。
脚注2: この行は、ご使用のデータベース・バージョンとインストール・パスに基づくカスタマイズが必要です。
脚注3: この行は、ご使用のデータベース・バージョンとインストール・パスに基づくカスタマイズが必要です。