5 Upgrading to RUEI 6.0.1

This chapter describes the procedure for upgrading an existing RUEI 5.x or 6.0.0 installation to release 6.0.1. The post-installation configuration procedure is described in Chapter 6, "Configuring RUEI".

If the DVD is not automatically mounted, use the following commands to mount it:

mkdir -p /mnt/dvd
mount /dev/dvd /mnt/dvd

Note:

In the rest of this chapter it is assumed that the RUEI DVD is mounted on /mnt/dvd.

Note that the upgrade procedure described below should be performed as the root user unless indicated otherwise.

5.1 Upgrading From RUEI 5.x to 6.0.1

This section describes the procedure for upgrading from an existing RUEI 5.x installation to release 6.0.1.

Important:

Before proceeding with the upgrade, make a backup of your configuration. Select Configuration, then System, then Maintenance, and then Backup and restore. The configuration backup is required in case of a rollback. In addition, it is strongly recommended that you create a database backup. Information on database backup procedures is available at https://support.oracle.com/CSP/ui/flash.html.

Upgrading Accelerator packages

If your RUEI installation makes use of accelerator packages (such as for Oracle E-Business Suite or Siebel), these must be upgraded at the same time as the RUEI system. Ensure you follow the sequence of steps described in the rest of this section.

Upgrading the Reporter System

Do the following:

Copy the RUEI distribution pack (Vxxx.zip) to the Reporter system /root directory, and unzip it. Repeat the unzip action for all required accelerator packages. Issue the following commands:
```
cd /root
unzip Vxxx.zip
```

Install the XML::Twig module by issuing the following commands:

cd /mnt/dvd/Server
rpm -Uhv perl-XML-Twig-3.26-*.fc6.noarch.rpm \
perl-XML-Parser-2.34-*.x86_64.rpm

Install the Java Runtime Environment (JRE). Note that this step can be skipped if you are upgrading from RUEI 5.1. Issue the following commands:
```
cd /root/RUEI/Java
chmod +x ./jre-1_5_0_21-linux-amd64-rpm.bin
./jre-1_5_0_21-linux-amd64-rpm.bin
ln -s /usr/java/jre1.5.0_21 /usr/java/jre
```
Note you are prompted to accept the Java license agreement. You cannot continue until you have done so.

This installs the JRE from a standalone package bundled with the RUEI distribution set, rather than the one built into the database.

Temporarily stop all processing by issuing the following command:

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

For each Collector system, issue the following commands:
```
./ruei-upgrade-5.x-6.0.sh stop_collector Collector-IP-address
```
where Collector-IP-address is the IP address of the collector system. Note that this command must also be issued for the local Collector (localhost).

Note that this step can be skipped if you are upgrading from RUEI 5.1. Update the /etc/ruei.conf file by issuing the following commands:

cp /etc/ruei.conf /etc/ruei.conf.50
cp /root/RUEI/extra/ruei.conf.upgrade /etc/ruei.conf
chmod 644 /etc/ruei.conf
source /etc/ruei.conf
chown $RUEI_USER:$RUEI_GROUP /etc/ruei.conf

Update the RUEI database instance by issuing the following commands:

cd /root/RUEI/60
cp ruei-prepare-db.sh /home/oracle
cp ruei-check.sh /home/oracle
chmod +x /home/oracle/ruei-*.sh
su - oracle
export ORACLE_HOME=/u01/app/oracle/product/11.1.0/db_1
./ruei-prepare-db.sh
exit

Upon completion, you should again be the root user.

Upgrade the RUEI Reporter RPMs by issuing the following commands:
```
cd /root/RUEI/extra
./ruei-upgrade-5.x-6.0.sh rpm_pre_install
cd /root/RUEI/60
chmod u+x ./ruei-install.sh
./ruei-install.sh *.rpm
cd /root/RUEI/extra
./ruei-upgrade-5.x-6.0.sh rpm_post_install
```
Note:
When upgrading a Reporter system that has little or no replay data on its local Collector, "*LTS?*" errors can be reported. These can be safely ignored.
Note that this step can be skipped if you are upgrading from RUEI 5.1. Enable additional fonts for PDF generation. Because the PDF generator uses Java libraries, these need to be made available to Java. Copy (or move) the RUEI included fonts to the appropriate Java directory. For example:
```
cp /opt/ruei/gui/include/bi_publisher/fonts/* \
/usr/java/jre/lib/fonts/
```
Restart the Apache Web server by issuing the following command:
```
/sbin/service httpd restart
```
Important:
At this point you should complete the Collector upgrade procedure described below before proceeding with step 11.
Restart processing (after you have upgraded all Collector systems) by issuing the following commands:
```
cd /root/RUEI/extra
./ruei-upgrade-5.x-6.0.sh start_ruei
```

The procedure for upgrading the Reporter system is complete.

Note:

After completion of the upgrade procedure, the default URL prefix masking action is set to "No replay". Review this setting (as described in the Oracle Real User Experience Insight User's Guide) to determine whether it meets your operational requirements.

Note:

During and after the upgrade procedure, if error or information messages appear in the event log (select System, then Status, and then Event log), you should mark them as read after completing the upgrade procedure, and monitor whether new messages are reported. In the event of re-occurring error messages, you should contact Customer Support.

Upgrading the Collector System(s)

Do the following:

Note steps 1 through 4 are only required if you are upgrading from RUEI 5.0. If you are upgrading from RUEI 5.1, you should proceed directly to step 5.

Remove the line containing the entry /home/oracle/bin/ruei-clean.sh from Oracle's crontab file by issuing the following commands:
```
su - oracle
crontab -e
exit
```
Stop the Oracle database, and remove the installation script so that it will no longer be started after a reboot, by issuing the following commands:
```
service oracledb stop
chkconfig --del oracledb
```
Note that if stopping the Oracle database service seems to take an usually long period of time, you should open a second terminal and kill any running process called rsynclogdird.
Stop the Apache Web server by issuing the following commands:
```
service httpd stop
chkconfig --del httpd
```
De-install all RUEI RPMs (except ux-collector) by issuing the following command:
```
rpm -qa | grep ^ux-.*-5.0 | grep -v ^ux-collector | xargs rpm -e
```
Copy the RUEI distribution pack (Vxxx.zip) to the Collector system /root directory, and unzip it. Issue the following commands:
```
cd /root
unzip Vxxx.zip
cd /root/RUEI/60
```
Install the Java Runtime Environment (JRE). Note that this step can be skipped if you are upgrading from RUEI 5.1. Issue the following commands:
```
cd /root/RUEI/Java
chmod +x ./jre-1_5_0_21-linux-amd64-rpm.bin
./jre-1_5_0_21-linux-amd64-rpm.bin
ln -s /usr/java/jre1.5.0_21 /usr/java/jre
```
Note you are prompted to accept the Java license agreement. You cannot continue until you have done so.

This installs the JRE from a standalone package bundled with the RUEI distribution set, rather than the one built into the database.

Note that this step can be skipped if you are upgrading from RUEI 5.1. Update the /etc/ruei.conf file by issuing the following commands:

cp /etc/ruei.conf /etc/ruei.conf.50
cp /root/RUEI/extra/ruei.conf.upgrade /etc/ruei.conf
chmod 644 /etc/ruei.conf
source /etc/ruei.conf
chown $RUEI_USER:$RUEI_GROUP /etc/ruei.conf

Convert the Replay store and upgrade the RUEI Collector RPM by issuing the following commands:

cd /root/RUEI/extra
chmod +x ruei-upgrade-5.x-6.0.sh
./ruei-upgrade-5.x-6.0.sh convert_replay_store
cd /root/RUEI/60
chmod +x ruei-install.sh
./ruei-install.sh collector

Repeat the above steps for each Collector system in your RUEI infrastructure.

At this point, you should return to step 10 of the Reporter system upgrade procedure.

5.2 Upgrading From RUEI 6.0.0 to 6.0.1

The upgrade procedure from version 6.0.0 to 6.0.1 only takes a few minutes. There is a short interruption of the Collector service, but it is automatically restarted during the upgrade.

Important:

Reporter System

The Reporter upgrade procedure described in this section applies to both single server installations as well as dedicated Reporter systems.

Do the following:

Login to the Reporter as root. Within the /root directory, unzip the RUEI zip file, and go to the directory containing the application files. Repeat the unzip action for all required accelerator packages. Use the following commands:
```
cd /root
unzip Vxxxx.zip
```

Stop all processing on the Reporter system using the following commands:

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

Install the new versions of the RPMs using the following commands:

cd /root/RUEI/60
chmod +x ruei-install.sh
./ruei-install.sh *.rpm

As the moniforce user, restart processing using the following commands:
```
cd /root/RUEI/extra
./ruei-upgrade-5.x-6.0.sh start_ruei
```

Collector System(s)

For each required Collector system, login as root. Within the /root directory, unzip the RUEI zip file, go to the directory containing the application files, and install the new versions of the RPMs. Do the following:

Unzip the RUEI distribution package using the following commands:
```
cd /root
unzip Vxxxx.zip
```

Upgrade the Collector RPMs using the following commands:

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

5.2.1 Rolling Back to Version 6.0.0

This section describes the procedure to rollback to version 6.0.0 after upgrading to version 6.0.1. Note that the Collector included in the Reporter installation is automatically rolled back during the described procedure. However, remote Collector systems must be individually rolled back. The procedure to do this is described later in this section.

Important:

Be aware that it may not be possible to restore your system to its exact state prior to upgrading. It is strongly recommended that you contact Customer Support before rolling back an upgrade.

Login to the Reporter system as root. Within the /root directory, unzip the RUEI 6.0.0 distribution zip file, and go to the directory containing the application files. Use the following commands:
```
cd /root
unzip Vxxx.zip
```
Important:
Ensure that the directory where you place the 6.0.0 distribution pack does not conflict with the 6.0.1 release. In addition, if your RUEI installation makes use of accelerator packages (such as Oracle E-Business Suite or Siebel), repeat the unzipping for all previously installed accelerator packages.
Stop all processing on the Reporter system by issuing the following commands:
```
cd /root/RUEI/60
./ruei-upgrade-5.x-6.0.sh stop_ruei
```

Restore the previous RPMs by issuing the following commands:

cd /root/RUEI/60
chmod +x ruei-install.sh
./ruei-install.sh *.rpm

Restart processing by issuing the following commands:

cd /root/RUEI/extra
./ruei-upgrade-5.x-6.0.sh start_ruei

Rolling Back Remote Collector Systems

Do the following:

Login to the remote Collector system as root. Within the /root directory, unzip the 6.0.0 distribution zip file, and go to the directory containing the application files. Issue the following commands:
```
cd /root
unzip Vxxx.zip
```
Important:
Ensure that the directory where you place the 6.0.0 distribution pack does not conflict with the 6.0.1 release.

Restore the previous RPMs by issuing the following commands:

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

5.3 Rolling Back From 6.0.x to 5.1.x

This section describes the procedure to rollback to version 5.1.x after upgrading to version 6.0.x. Note that the Collector included in the Reporter installation is automatically rolled back during the described procedure. However, remote Collector systems must be individually rolled back. The procedure to do this is described later in this section.

Important:

Be aware that it may not be possible to restore your system to its exact state prior to upgrading. It is strongly recommended that you contact Customer Support before rolling back an upgrade.

In addition, you will require a configuration backup of your 5.1.x installation, as well as the 5.1.x and 6.0.x distribution packages to perform the described rollback procedure.

Do the following:

Login to the Reporter system as root. Within the /root directory, unzip the previous 5.1.x distribution package, and go to the directory containing the application files. Issue the following commands:
```
mkdir /root/rollback51
cd /root/rollback51
unzip Vxxx.zip
```
Important:
If your RUEI installation makes use of accelerator packages (such as Oracle E-Business Suite or Siebel), repeat the unzipping for all previously installed accelerator packages.

Stop all RUEI processing by issuing the following commands:

cd /root/RUEI/extra
chmod +x ./ruei-rollback-6.0-5.x.sh
./ruei-rollback-6.0-5.x.sh stop_ruei

Execute the RPM pre-install phase by issuing the following command:
```
./ruei-rollback-6.0-5.x.sh rpm_pre_install
```
Remove the ADF RPM and downgrade existing Reporter RPMs by issuing the following commands:
```
rpm -e ux-adf
cd /root/RUEI/60
./ruei-install.sh /root/roolback51/RUEI/51/*.rpm
```
Execute the RPM post-install phase by issuing the following commands:
```
cd/ root/RUEI/extra
./ruei-rollback-6.0-5.x.sh rpm_post_install
```
Re-start the Apache Web server by issuing the following command:
```
service httpd restart
```
At this point, you should rollback all remote Collector systems (using the procedure described below). Proceed to step 7 after you have rolled back all remote Collector systems. If your installation does not make use of remote Collector systems, you should proceed directly to step 7.
Restart RUEI processing by issuing the following commands:
```
cd /root/RUEI/extra
chmod +x ./ruei-rollback-6.0-5.x.sh
./ruei-rollback-6.0-5.x.sh start_ruei
```
Be aware that this phase can take a considerable amount of time.
Restore the RUEI configuration backup you created prior to upgrading by selecting Configuration, then System, then Maintenance, then Backup and restore, and then select Restore system from file.

Troubleshooting Rollback Problems

The rollback script ruei-rollback-6.0-5.x.sh logs its actions in the file /tmp/ruei-rollback-6.0-5.x.log. If you encountered any problems during the rollback, please attach this file to any request to Customer Support.

5.3.1 Rolling Back Remote Collector Systems

This section describes the procedure to rollback remote Collector systems to version 5.1.x after upgrading to version 6.0.x.

Do the following:

Login to the remote Collector system as root. Within the /root directory, unzip the previous 5.1.x distribution package, and go to the directory containing the application files. Issue the following commands:
```
mkdir /root/rollback51
cd /root/rollback51
unzip Vxxx.zip
```

Restore the Collector replay store by issuing the following commands:

cd /root/RUEI/extra
./ruei-rollback-6.0-5.x.sh convert_replay_store

Restore the previous Collector RPMs by issuing the following commands:

cd /root/RUEI/60
./ruei-install.sh /root/rollback51/RUEI/51/ux-collector-*.rpm

Repeat the above procedure for each required remote Collector system. When ready, return to the Reporter rollback procedure.

5.4 Rolling Back From 6.0.x to 5.0.x

This section describes the procedure to rollback to version 5.0.x after upgrading to version 6.0.x. Note that the Collector included in the Reporter installation is automatically rolled back during the described procedure. However, remote Collector systems must be individually rolled back. The procedure to do this is described later in this section.

Important:

Be aware that it may not be possible to restore your system to its exact state prior to upgrading. It is strongly recommended that you contact Customer Support before rolling back an upgrade.

In addition, you will require a configuration backup of your 5.0.x installation, as well as the 5.0.x and 6.0.x distribution packages to perform the described rollback procedure.

Do the following:

Login to the Reporter system as root. Within the /root directory, unzip the previous 5.0.x distribution package, and go to the directory containing the application files. Issue the following commands:
```
mkdir /root/rollback50
cd /root/rollback50
unzip Vxxx.zip
```
Important:
If your RUEI installation makes use of accelerator packages (such as Oracle E-Business Suite or Siebel), repeat the unzipping for all previously installed accelerator packages.

Stop all RUEI processing by issuing the following commands:

cd /root/RUEI/extra/
chmod +x ./ruei-rollback-6.0-5.x.sh
./ruei-rollback-6.0-5.x.sh stop_ruei

Execute the RPM pre-install phase by issuing the following command:
```
/ruei-rollback-6.0-5.x.sh rpm_pre_install
```

Restore the previous RPMs by issuing the following commands:

rpm -e ux-wlp
rpm -e ux-adf
cd /root/rollback50/RUEI/50
rpm -Uhv --oldpackage ux-*

Execute the RPM post-install phase by issuing the following command:
```
cd /root/RUEI/extra/
./ruei-rollback-6.0-5.x.sh rpm_post_install
```
At this point, you should rollback all remote Collector systems (using the procedure described in Section 5.4.1, "Rolling Back Remote Collector Systems"). Proceed to step 7 after you have rolled back all remote Collector systems. If your installation does not make use of remote Collector systems, you should proceed directly to step 7.
Re-start the Apache Web server by issuing the following command:
```
service httpd restart
```
Restart RUEI processing by issuing the following command:
```
./ruei-rollback-6.0-5.x.sh start_ruei
```
Restore the backup of the /etc/ruei.conf file (as the root user) you created at the start of the upgrade procedure by issuing the following commands:
```
mv /etc/ruei.conf /etc/ruei.conf.60.backup
cp /etc/ruei.conf.50 /etc/ruei.conf
```
Restore the RUEI configuration backup you created prior to upgrading by selecting Configuration, then System, then Maintenance, then Backup and restore, and then select Restore system from file.

5.4.1 Rolling Back Remote Collector Systems

This section describes the procedure to rollback remote Collector systems to version 5.0.x after upgrading to version 6.0.x.

Do the following:

Login to the remote Collector system as root. Within the /root directory, unzip the previous 5.0.x distribution package, and go to the directory containing the application files. Issue the following commands:
```
mkdir /root/rollback50
cd /root/rollback50
unzip Vxxx.zip
```

Restore the Collector replay store by issuing the following commands:

cd /root/RUEI/extra
./ruei-rollback-6.0-5.x.sh stop_collector
./ruei-rollback-6.0-5.x.sh convert_replay_store

Restore the previous Collector RPMs by issuing the following commands:

cd /root/RUEI/60
./ruei-install.sh /root/rollback50/RUEI/50/ux-collector-*.rpm

Repeat the above procedure for each required remote Collector system. When ready, return to the Reporter rollback procedure.